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PREFACE _ 

, Mn0 yas developed by Control Data 
The Network Operating System ^ N0: >;\ ^ ^ i t i es for time-sharing and 
Corporation to provide network capab U ^ ^ ^^ faatch 

transaction processing, ]|" a °°l;l " 7n Ser ies Computer Systems; 
processing, on CONTROL DATA CYBER 1 70 Se r s t P Systems; 
CDC CYBER 70 Series, Models 71, 72, 73, and 
and CDC 6000 Series Computer Systems. 

t^.rn..l -.1nt.n.n. : ^P""^^^" ^^on'of ' »OS 

■.5:s-:.: n r t ;^: c r::s. t .*^: s i."toiisrsu t ; h ::. th .r. f.«u, -.-,,- 

in other N0S manuals. 



CONVENTIONS 




• LCM/LCME cannot I i nk ma inf rames and does not have a 
distributive data path CDDP) capabil i ty . 

. rM/i pmp transfer errors initiate an error exit, not a 

• LCM/LCME transier eiiuia „. MOACC Oof . ppnce Manual for 
half exit. Refer to the COMPASS Reference nanu 

complete information. 

The Model 176 supports direct LCM/LCME * r-^/ ^f^ss 
instructions (octal codes 014 and 015). Refer 
Reference Manual for complete informatTon. 

in this manual the acronym ECS refers to all 1 [^"^fr/: 51 

"-cry on the CYBER 170 Series However ^^ "text. of 

muU.imainfr.aroe environment or DDP access, a"« 

exc luded . 

in this manual, the order of importance of headings is denoted as 

f o I lows . 

. FVFL 1 HEADINGS ARE FULL CA P* AND UNDERLINED, 

LEVEL 2 HEADINGS ARE FULL CAPS 



i pwpI 3 Headings are 



First-Capped and Underlined 



Level 4 Headings are First-Capped 

x * -, i ■ momnrv word formats are as follows: 
Conventions for central memory woru 



1 1 l 



60454300 B 



• Cross-hatching indicates a field is not used by or is 
not applicable to a function processor. However, CDC 
reserves the right to assign these fields to system use 

in the future. 

• Fields reserved for system use are so labeled. 

• Fields labeled with mnemonics indicate a specific 
parameter must be inserted (generally described after 
the word f o rmat ) . 

• Fields with numeric identifiers indicate the actual 
value that is used or returned for a particular function 

RELATED PUBLICATIONS 

For further information concerning CYBER 170, CYBER 70, and 6000 
Series Computer Systems, the N0S time-sharing systems, and the 
user interface for N0S, consult the following manuals. 
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INTRODUCTION 



A st 
anal 
sys t 
to b 
comm 
st im 
runs 
s t i m 
usi n 
the 
run 



imu L 
y ze 
em r 
e en 
uni c 
u lat 

on 
u lat 
g ex 
re la 
with 



ator enters a hypothetical work load into the system to 
the effects of such a work load on response time and 
eliability. An internal stimulator allows the work load 
tered into the system without the use of any external 
ations equipment on the related terminals. An internal 
or is part of the stimulated environment (that is, it 
the same computer that it is stimulating). An external 
or allows the work load to be entered into the system 
ternal communications equipment, but without the use of 
ted terminals. An external stimulator may or may not 
in the stimulated environment. 



The NOS stimulator software consists of the following programs: 



Pro g ram 
STIMULA 

1TS 

1TE 

DEMUX 



Description 

A CPU program that processes input from a 
session file and K display. 

A PP program called by STIMULA to enter 
the work load into the system. 

A PP program called by STIMULA to enter a 
work load into the system using external 
communications equipment. 

A CPU program that processes the stimulator 
output . 



Figure 24-1 i I lust rat es the relationship of the various 
stimulator modules. 



CALLING STIMULA 

The type of stimulation to be run is determined by the control 
statement used in the STMxxxx procedure file. The control 
statements STIMULA, ASTIM, and NSTIM all initiate the CPU 
program STIMULA. 



STIMULA CONTROL STATEMENT 

The STIMULA control statement initiates an internal stimulation 
that enters a work load into the system through TELEX or IAF. 
When used with IAF, the work load is entered directly to IAF 
without going through NAM (refer to figure 24-2). STIMULA can 
be run as the only front end in the system or in conjunction 
with live terminals. Only interactive terminals can be 
stimulated. The format on the control statement 



is as f o I lows : 
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Session K-Oisplay Change Control 

File Input File Statement 



output 
file 



^ V W * 



STIMULA 



1TS/1TE 



STIMOUT 
file 



DEMUX 



Jk. 



log 
file 



user- 
supplied 

post- 
processor 



Figure 24-1. Relationship of Stimulator Modules 



60454300 B 



24-2 



stimulated. The format on the control statement is as follows 
STIMULA(I=lfn) 

Lfn Local file to be used as the session file. 
If not specified, the initial K display 
requests the session filename. 



stimulator 
software 



channel 



TELEX 

or 

IAF 



Figure 24-2. Hardware Configuration for STIMULA 



ASTIM CONTROL STATEMENT 

The ASTIM control statement initiates an external stimulation 
that enters a work load into the system through TELEX. The 
stimulation software communicates with a TS type 6676 or 
2550-100 multiplexer while TELEX communicates 'with a TT type 
multiplexer. The ports of the TS and TT type equipment are 
hardwired together (refer to figure 24-3). ASTIM can be run 
the only front end in the system or in conjunction with live 
terminals. Only interactive terminals can be stimulated. The 
format of the control statement is as follows: 



as 



ASTIM(I=lfn) 
Ifn 



Local file to be used as the session file 
If not specified, the initial K display 
requests the session file name. 



communication 
lines 





6676 

or 

2550-100 




6676 














stimulator 
software 






TELEX 


• 

• 

■ • 


channel 


channel 















ITS! 



[TT] 



Figure 24-3. Hardware Configuration for ASTIM 
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NSTIM CONTROL STATEMENT 

The NSTIM control statement initiates an external stimulation 
that enters a work load into the system through Network Access 
Method (NAM) and its applications (in particular, IAF). The 
stimulator software communicates with a TS type 6676 or 
2550-100 multiplexer while the NAM software communicates with an 
NP type communications processor (255x Host Communications 
Processor). The ports of the TS and NP type equipments are 
hardwired together (refer to figure 24-4). NSTIM can be run as 
the only front end or in conjunction with live terminals. Only 
interactive terminals can be stimulated. The format of the 
NSTIM control statement is as follows: 



NSTIM(I=lfn) 
Ifn 



Local file to be used as the session file 
If, not specified, the initial K display 
requests the session file name. 







6676 

or 

2550-100 




255x 












stimulator 
software 




network 
software 


• 
• 
• 


channel 


channel 

















[TS] 



[NP] 



Figure 24-4. Hardware Configuration for NSTIM. 



FUNCTIONAL OVERVIEW 

The following paragraphs describe what functions STIMULA, 
1TS/1TE, and DEMUX have with regards to the NOS stimulation 
software. 



STIMULA 

STIMULA is a CPU program that is initiated by the STIMULA, 
ASTIM, or NSTIM control statements. The major functions of 
STIMULA include the following. 



• Access session file and convert session 
format suitable for the stimulation. 



text i nto a 



• Process K-display input and directive file input that 
describes the terminal characteristics (such as line 
speed, think time, logout delay, and so on). 
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. Build tables that will be needed by the stimulator 
drivers 1TS or 1TE. 

M .«. , .H Mll | fl tion driver status during the stimulation 

. "omtor stimulation dri f Lushed when required, 

run. The output buTT.ers w. stimulation 

the next best task computed, and the end ot stimu 

detected. 
. once stimulation is complete, the ST.IHOUT file is 



wri tten 



ITS AND 1TE 




Network Access Method applications. 

The major functions of 1TS and 1TE include: 

1. initialize control table in STIMULA with maximum number 
of terminals that can be stimulated. 

• ' i ~+ * r. a -ho <snecified by the AG and AD 

2. Activate terminals at a rate speciTiea uy 

K-displaydirectives. 

3. Transmit data to the host at a rate specified by the IS 
K-display parameter. 

4. Receive data from the host at a rate specified by the LS 
K-display parameter. 

5. Process think time delays as .specified ^^ ^ ^J JJ 
K-display directives and optional think times as set 
the session text. 

6. Process logout delay as specified by 10 K-display 
di recti ve. 

7. Process repeat count processing as specified by the RC 
and LF K-display directives. 

8. Process task requests as set in session text. 



9. Process dynamic login requests as 
text. 



set in the sessi on 



the host to the 



10 Return all data sent or received from the host 
output buffer as specified by the RO K-display 



di recti ve. 
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In addition to the above functions, 1TE has the following 
additional functions. 

1- Returns trace data to the output buffer as specified by 
the TE and TL K-display directives. 

2. Processes source line input as specified in the session 
text . 

3. Processes line regulation when encountered. 



DEMUX 

DEMUX is a CPU post processor program. It is run after the 
stimulation is complete. Its main functions include the 
f o I lowi ng . 

1. Sort terminal data by terminal number. 

2. Sort trace data by terminal number. 

3. Convert terminal data from ASCII to display code. 

4. Convert trace data to readable output. 

5. Process time stamps found in STIMOUT. 

Output from DEMUX can be input into a user supplied program to 
analyze the stimulation. 

STIMOUT FILE FORMAT 

When output is to be recovered (R0=0N K-display parameter), a 
file called STIMOUT is created by STIMULA. Two types of 
informtion are found on this file; upline and downline data 
information and trace information. 

The upline and downline information includes all data sent and 
received by the stimulator with time stamps for when a carriage 
return was sent by the terminal and a time stamp for when the 
first character of output was received. The format for this 
type of information is in the following format. 



59 




47 




35 


23 


II 









tn 


char 


char 


char 




char 





tn Terminal number for which data corresponds to. 
char Data information in the following format. 
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II 10 9 



m 



data 



data 



Time stamp flag. 

Mi I Lisecond flag. 

ASCII character in bits 9 through 
if t and m are zero. Second 
time stamp if t is 1 and m is 0. 
Mi I Li second time stamp if t and m 

are 1. 

Trace information is written to the STIMOUT file if .the TE and 
TL K-display parameters have been used. The trace information 
is contained in a two-word packet as follows. 



59 



tn 



tn 



47 



ja 



35 



status 



23 



sec 



out 



msec 



reserved 



tn 

status 

sec 

msec 

ja 

i n 

out 



Terminal number 

Byte and 1 from the first word of TE 

Value of second clock 

Value of millisecond clock 

Value of TOCA entry for terminal 

Input character 

Output character 



Trace information is helpful when debugging 1TE or verifying 
hardware. 
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DEMUX sorts information on the STIMOUT file by terminal number 
and by data or trace information. Data is also converted into 
readable display code. 



EST ENTRIES USED FOR STIMULATIONS 

Depending on the stimulator that is being initiated, certain EST 

entries must be present in the EST table. This section 

describes the format of these EST entries and when they are 
requi red . 

Two types of EST entries are used for external stimulation while 
only one EST entry is needed for internal stimulation. The TT 
EST entry is always required by TELEX or IAF. The stimulator 
software does not get information directly from this type of 
EST entry. The stimulation software requires an EST entry (TS 
type EST) for external stimulation only. One TS EST entry is 
required for each 6676 or 2550-100 multiplexer to be driven by 
the stimulator. Up to eight 6676 or 2550-100 multiplexers, or 12 
interactive lines can be driven by ASTIM and NSTIM. If NHP is 
being stimulated, the TT EST entries are replaced by NP EST 
ent ri es . 



STIMULA EST ENTRY 

The following CMR deck entry should be present when the STIMULA 
control statement is to be used. 

EQnn = TT,s t, ct ,1 ,ch,0, li nes . 

EST ordinal 



nn 
st 

ct 

ch 

I i nes 



Equi pment status 

ON - equipment available for system use 
OFF - equipment unavailable 

Cont roller number 

Channel number 

Number of lines to be stimulated 



The general format for this EST entry is as follows 



59 53 



47 



41 



35 



23 



8 5 






cp 


O 


ch 


lines 


s 


TT 


ct 





(type) 
1 
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cp Control point number 

c h Channel to be used for stimulation 

lines Maximum number of lines that can be stimulated 

s Equipment status: 

= device available (ON) 

1 = device unavailable (OFF) 

ct Controller number 

type MUX type: 

= rea I 

1 - stimu la tor 

The channel should not have an equipment connected to it. If it 
does, 1TD/1TN and 1TS may hang. This EST entry must be turned 
on before TELEX or IAF are initiated. 

The stimulator software does not use this EST entry directly. 
Routine 1 TD/1 TN finds the stimulator EST entry and assigns it to 
the timesharing subsystem control point. The maximum number of 
lines to be stimulated and the channel to be used for 1TD/1TN 
and ITS communications are set into bytes 3 and 4 of the first 
word in the 1TD/1TN message buffer. Routine 1TS searches for 
the 1TD/1TN message buffer to get this informtion. For this 
reason, TELEX or IAF must be initiated before the stimulator. 

ASTIM ENTRIES 

Two types of CMRDECK entries are required to be present when the 
ASTIM control statement is initiated. 

The stimulator software requires the following EST entry. 

EQnn=TS,st,ct ,0,ch,0, lines, 
while the TELEX/IAF software requires the following entry. 

EQnn=TT,st,ct,10,ch,0, lines. 



nn 
st 
c t 
ch 
I i nes 



EST ordinal 

ON/OFF status 

Control ler number 

Channel 

Maximum number of lines to be stimulated 



Two EST entries are required since the stimulator may be 
running in a different machine than is being stimulated. Also, 
there are two multiplexers being used; the stimulator is driving 
one and TELEX/IAF is driving one (refer to figures 24-3 and 
24-4). 

The central memory format for the TS and TT EST entries is as 
f ol lows . 
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59 53 


47 


41 35 




23 Hi 


3 ! 


5 





cp 





ch 


1 ines 


s 

t 


TS 


ct 








59 53 47 41 35 23 II 8 5 





cp 





ch 


lines 


s 

t 


TT 


ct 





10 



NSTIM ENTRIES 

Two types of CMR deck entries are required to be present when 
the NSTIM control statement is initiated. 

The stimultor software requires the entry. 

EQnn = TS,s t ,ct ,0,ch,0, I i nes . 
while the NHP software requires the following. 

EQnn=NP,s t,eq, i n, ch ,0,node . 



nn 
st 
ct 
eq 
i n 
ch 

node 
I i nes 



EST ordi na I 

ON/OFF status 

Controller number 

Equipment number 

Index number 

Channe I 

Node number 

Maximum number of lines 



The central memory format for the TS and NP EST entries is as 
f o I lows . 



59 


53 


47 


41 


35 




23 


II 1 


3 








cp 





ch 


lines 


s 
t 


TS 


ct 





59 53 47 41 35 23 II 8 5 





cp 





ch 


node 


s 

t 


NP 


eq 





in 
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TABLES USED FOR CPU/PP COMMUNICATION 

This section describes the tables that are used for 
communication between STIMULA and 1TS/1TE. All tables are 
built by STIMULA and they reside in STIMULA's field length 



TSCR - SCRATCH TABLE 

This table is used to contain code, FETs, and buffers that are 
used once the stimulation has been initiated. The code is 
responsible for recovering output and selecting the next best 
task to process. If output is not to be recovered, this table 
remains empty. 



TTER ■■- TERMINAL TABLE 

TTER (refer to figure 24-5) is generated for 1TS and 1TE, to be 
used for control of the stimulation run. 



TSTX - SESSION TEXT TABLE 

A session consists of 5 bytes of session text per word, 
session is linked to the next session by a control word, 
are n words per session. The byte format is as follows. 



Each 
The re 



II 


7 


cc 


char 



cc Output control code (binary): 

100 Normal output 

010 End of output line 

001 End of sessi on 

char ASCII character 

The format of the session link is as follows. 



59 



index of next 
session 
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59 56 53 47 







nt-1 



nt 



nt *2"1 



nt*2 



nt*3~1 



nt*3 



nt*4~1 



nt*4 



nt*5"1 



35 2 1 23 



oaddr 



r c 



ttd 



ct 



oaddr 



re 



ttd 



is 



ct 



tts 



IS 



Id 



tts 



oaddr 



acct 



taddr 



oaddr 



acct 



taddr 



used by 1TS for output recovery 



used by 1TS for output recovery 



laddr 



in 





laddr 



k\^\\\\\\\N 



N\\\\\\\\NX1 



in 





ck 



ck 



ott 



oft 



cnt 



cnt 



Figure 24-5. TTER Table 



60454300 B 



24-12 • 



nt 
f 



Number 
F Lags 

Bit 

59 
58 
5 7 



of terminals (number of entries in table) 



Description 

Off line 
Di sab led 
Character encountered 



milliseconds) 
mi I li seconds) 



Current byte of output data word 

Address of current output data word 

Repeat count 

Think time delay in seconds 

Character time in milliseconds 

Timi ng clock 

Line speed (character time in 

Input speed (character time in 

Logout delay in seconds 

Think time in seconds 

Optional think time in seconds 

R ese r v e d f i e I d 

Special account number flag 

Address for current task table entry 

Byte of output word for 1st output line 

Address of output data word for last output 

Character counter 

Number of times terminal encountered line 

regu lat ion 

Figure 24-5. TTER Table (Continued) 

This table is built by STIMULA from the data contained on the 
session file. It is used by 1TS/1TE during the stimulation to 
get the next character to transmit to TELEX/IAF. The b and 
oaddr fields of the first word of the terminal table entry are 
used to get the next character for output. 

TASK - TASK TABLE 

This table is used for selection of the next best task. It is 
built by STIMULA and is used by STIMULA during the stimulation 
to determine the next best task to be executed. 



b 

oaddr 

re 

ttd 

ct 

ck 

Is 

i s 

Id 

tts 

1 1 
r 
acct 

t addr 
lb 

1 addr 
i n 
cnt 



59 



23 



17 



II 



task name 



task address 



ccals 



teals 



desired percentage (floating point) 



actual percentage (floating point) 
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c ca Is 
teats 



Comp Leted task cat I 
Tot at ask ca I I 



TSPT - SESSION POINTERS 

This tabLe is used only during STIMULA initialization 
not present when the stimulation is in progress. 



It i s 



59 


47 


35 


23 


7 


tt 


Is 


tty 


re 


index 


is 


Id 






1 1 

Is 

tty 

r c 

i ndex 

i s 

Id 



Think time 

Line speed 

Terminals as s i gned 

Repeat count 

Index in TSTX of session 

Input speed in characters/second 

Logout delay in seconds 



RA LOCATIONS (STIMULATOR USAGE) 

The RA locations table is shown in figure 24-6, These entries 
contain information that can be used by all active stimulation 
drivers. 
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59 53 47 



RASC 



RA+1 



RANT 



RATK 



RACW 



RATK 



RAMD 



RAPP 



ac 



eq 



ai 



35 29 23 



Iwa 



fwa 



system communications 



address of next best task 



FWA of task table 



nt 



Inl 



tm 



n2 



ad 







dtask 



fl 



number of entries in TCWD 



I wa 

fwa 

dtask 

ac 

nt 

tm 

ad 

ft 

eq 

ln1 

ln2 

a i 



0, Loop on session file 

1, loop- on session record- 
LWA+1 of session file 

First word address of session file 

Number of default task calls 

Activation count 

Total number of stimulated terminals 

Think time mask 

Activation delay 

Field length needed for stimulation 

Equipment ordinal for multiplexer 

Minimum line number to recover trace information 

Maximum line number to recover trace information 

Activation indicator contains control table ordinal 

of stimulation driver currently activating 

terminals 

Figure 24-6. RA Location Table 
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TCWD - TABLE OF CONTROL WORDS 

The table of control words includes one entry for each 
stimulation driver called as follows. 



59 



TCWD 



tb 



47 



35 



17 



eqnt 



fet 



ttadd 



c Completion bit (set by 1TS/1TE) 

= stimulation driver active 

1 = stimulation driver complete 

tb Terminal number bias (set by STIMULA) 

eqnt For 1TS (set by 1TS), 12-bit nt 

For 1TE (set by 1TE), 6-bit eq and 6-bit nt 
eq = Equipment EST ordinal 
nt = Number of terminals for equipment 
The total number of line regulations for the 
stimulator driver is returned in this byte at the 
completion of the stimulation. 

fet Output file fet (0 if no output to be recovered) 
(set by STIMULA) 

ttadd Terminal table entry address (set by STIMULA) 
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STIMULA ROUTINES 

Figure 24-7 shows the main flow for STIMULA. 

The three entry points STIMULA, ASTIM, and NSTIM control the 
setting of the NPS (network product stimulation) flag, the mode 
(internal/external stimulation) flag, and whether 1TS and 1TE 
are called- The NPS flag is set only when the NSTIM control 
statement is evoked. This flag is used by TSF ..(translate 
session file) to determine if an end of line is to be 
terminated by a carriage return (this would be the case for ^ 
STIMULA and ASTIM) or by a DC3. The mode flag is used by PRS 
(preset), ICT (initialize control table) and SAC (set 
activation count). The mode flag is used to determine what 
format is used for the control table entries. The NSTIM and 
ASTIM entry points will also change the 1TS RA+1 requests to 
1 TE RA+1 requests. 



PRS - PRESET ROUTINE 

The routine PRS (preset) performs the following functions. 
1 .Crack the control statement arguments. 

2. Call 1TE or ITS to i ni t i a li ze TCWD (control word table) 
with the number of terminals and equipment number. 

3. Set the maximum number of terminals that can be 
stimulated into NT, MNT, and DSNT. 

4. Set the default activation rate. 

5. Modify character translation table if 64 character set 
i s enab led. 

6. Rewind the session file if it was specified on the 
control statement. 



TSF - TRANSLATE SESSION FILE 

The routine TSF (translate session file) performs the following 
f unct ions . 

1. If the session file was not specified on the control 
statement, the routine RSF (request session file) is 
called to attach the session file. The routine RSF 
will request K-di splay input from the operator 
regarding the location and name of the session file. 

2. Once the session file has been attached, TSF begins 
reading the session file and building the TSTX, TSPT 
and TASK tables. Each record in the session file is 
processed. If the record is a session record, the 
session text is converted to ASCII, set into the^TSTX 
table and an entry is added to the TSPT table. If the 
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(NPS) = 1 







(MODE) = 1 
(TS) = NE 



PRS 



preset 



TSF 



translate 

session 

file 



RSP 



request 

session 

parameters 



RMP 



request 
mixed param- 
eter input 




Figure 24-7. STIMULA Flow 
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3. 



record contains a task (the first character of the 
first word of the record is a $), then the task text 
is converted to ASCII, set into the TSTX table and an 
entry is added to the TASK table. The TSTX and TASK 
tables are completely built by TSF. The TSPT table 
will be modified at a later time. 

End of line and end of session control characters are 
set in the text table as required. These characters 
will cause special processing to take place in 1TS/1TE 



The session file is returned to the system by the main routine. 



RSP - REQUEST SESSION PARAMETERS 

The routine RSP (request session parameters) is responsible for 
requesting K-display input from the operator concerning the 
session parameter settings. At this time the operator can set 
the following session parameters . 

NT Number of terminals to stimulate 

LS Line speed 

IS Input typing speed 

TT Think time 

TI Think time increment 

AC Activation count 

AD Activation delay 

RC Repeat count 

LD Logout delay 

RO Recover output option 

LF Loop on session file option 

TE Equipment ordinal for trace 

TL Line number for trace 

Values entered at this time affect all terminals that are to be 
stimulated. On exit from RSP, the values to be used for the 
session parameters are stored in working storage. 

RMP - REQUEST MIXED PARAMETER INPUT 

The routine RMP (request mixed parameter input ) a I lows the 
operator to set the session parameters on a script basis. The 
operator may enter input to the st i mutator wi th the K display 
or a di rect ive change file. 

RMP calls the routine MXD to move the session parameters that 
were stored in working storage by RSP to TSPT. The routine DMX 
is called to build the K display to be used for mixed mode 
input. The routine KBI is called to process K-di splay input . 
The K-display input will be set into the appropriate TSPT 
entries immediately. On exit, the TSPT table is completely 
buitt. No more interaction with the operator is required by 
STIMULA. 
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SSA - SET SESSION ADDRESSES 



The routine SSA (set session addresses) is responsible for the 
following functions. 

1. Calculate the relocation address for the tables TSCR, 
TSER, TSTX, and TASK. 



2. Set the script pointers into RASC. 



3. 



Assign 
assign 
TSTP e 
termin 
dec rem 
assign 
the nu 
assign 
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then t 
When a 
termin 
word o 
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When a script is 

n is moved from the 

TTER entry for the 

field is 
the next script is 

to terminals unt i I 
ero. Scripts are 
The first script is 
e second script to 
pt to terminal n and 
to terminal n+1 . 
d any remai ni ng 
bit 58 of the f i rst 



STA - SET TASK ADDRESSES 

The routine STA (set task addresses) uses the relocation 
addresses calculated by SSA to set with the addresses of the 
task tab le . 



IOR - INITIALIZE OUTPUT RECOVERY 

If output is to be recovered from the stimulation run (that is, 
RO=ON was entered on the session parameter display), then the 
routine IOR (initialize output recovery) is called. IOR is 
responsible for setting up the FETs and buffers that are used 
by the stimulation drivers. The TSCR table is used to hold the 
code, FETs, and buffers used for recovering output. If output 
is not to be recovered, this table remains empty. 

IOR allocates space in TSCR and moves the recovery code, FETs, 
and buffers into TSCR. The FET address is set into TCWD (table 
of cont ro I wo rds ) . 



BSM 



BEGIN STIMULATION 



The routine BSM (begin stimulation) is responsible for setting 
the control word into RACW, moving the table TSCR, TTER, TSTX, 
and TASK to Low memory and calling the stimulation driver for 
the first entry in TCWD. The routine ICT (initialize control 
table) is called to set the terminal bias and the appropriate 
terminal table address into the control word table. 
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When BSM is ready to move the tables to Low memory, a move Loop 
is moved to high memory™ When this move Loop is executed, the 
tables TSCR, TTER, TSTX, and TASK are moved to Low memory. 
Once the tables are moved, the stimulation drivers # for the 
first entry in TCWD is called. The fi rst stimulation driver 
called is responsible for dropping the CPU and transfer control 
to the output recovery routine if needed. 



Figure 24-8 shows how BSM reorganizes 
the stimulation. 



lemory in preparation for 



RCO 



RECOVER OUTPUT 



relocated by 



If output is to be recovered, the routine RCO is 

BSM The first stimulation driver is responsible for 

transferring control to RCO. RCO performs three tasks while 
the stimulation is in progress: 

1. Compute the addresses of the next best task when a 
task address is needed. 

2. Scan all the output FETs being used and call CIO to 
flush the buffers to disk when the buffers are more 
than half full. 

3. Scan the TCWD to determine when the stimulation is 
comp Let e . 

Once the stimulation is complete, the control point queue 
priority and CPU priority are reduced. The routine COF 
(complete output files) is called to write the output data 
recovered by each stimulation driver to the file STIMOUT. 

RCO is flowcharted in figure 24-9. 



DESCRIPTION OF 1TS/1TE ROUTINES 

Depending on the stimulator control statement evoked, the CPU 
program STIMULA will call either 1TS or 1TE. Routine 1TS is the 
stimulation driver that interfaces with 1TD/1TN via a channel 
while 1TE is a stimulation driver that interfaces with a 6676 
or 2550-100 multiplexer. 

Both 1TS and 1TE binaries are generated from the 1TS Modify 
deck. If a DEFINE ASTIM is entered into the Modify directive 
file, the 1TE binary will be generated. If the DEFINE ASTIM is 
not present, then the 1TS binary is defined. Differences 
between 1TS and 1TE include: 

1. 1TS searchs for the 1TD/1TN message buffer to 

determine how many terminals to stimulate and what 
channel to use. 1TE gets this information from the TS 

EST entry. 
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RA 



RA+FL 



pointers 
TCWD 

code 

for 

table 

generation 

K-display 

processing, 

etc. 



TSCR 



TTER 



TSTX 



TASK 



TSTP 



Before 



RA 



RA+FL 



pointers 
TCWD 



TSCR 



TTER 



TSTX 



TASK 



unused 
dropped 

by 

stimulation 

driver 



move loop 



After 



Figure 24-8. BSM Memory Control 
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PES 

process end 
of stimu- 
lation 



OTD 



output 
task 
data 



end 



) 



Figure 24-9. RCO - Output Recovery 
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2. 1TE is Limited to driving 64 (100B) terminals. 1TS 
can drive up to 512 terminals. 

3. Channel interface in 1TS is geared to 1TD/1TN while 
1TE interfaces with a 6676 or 2550-100 multiplexer. 

4. HE provides a trace mechanism to allow the monitoring 
of 1TE during run time. 

The 1TS/1TE initialization is shown in figure 24-10 and the 
main loop is shown in figure 24-11. 

The formats of the 1TS and 1TE calls are as follows. 



59 41 


35 


17 


1TS 


cp 





addr 



59 41 


35 


17 


ITS 


cp 





addr 



addr if 1TS/1TE is being called to initialize the 
control word table TCWD. 

Address of entry in control word table TCWD for 
this copy of 1TS or 1TE. This call is made to 
initiate the stimulation. 

The CPU program makes an SPC RA+1 request when calling 1TS/1TE 
This allows the system to check the validity of the call 
instead of 1TS and 1TE checking it. 

The following discussion describes the more important routines 
in 1TS and 1TE. 



PRS - PRESET ROUTINE 

The preset routine is responsible for the following functions. 

1. Set channel instructions to use stimulator channel as 
specified in the EST entry. The routine ISC 
(initialize stimulator channel) is called to do this. 

2. 1TE preset will call the routine IMX to initialize the 
6676 or 2550-100 multiplexer. 
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initialization 



ICT 



initialize 

control 

table 




CTS 

check TELEX 

status 

(1TS only) 




stimulation 

SCP 

start 
central 
program 



IOR 



initialize 

output 

recovery 



JL 



SAD 



set 
addresses 



setTOCA 

table 

entries 




Figure 24-10. 1TS/1TE Initialization 
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SSL 



stimulation 

service 

loop 



_ ± 

update 
clocks 



JL 



check for 

end of 
stimulation 




end 
stimulation 




Figure 24-11. 1TS/1TE Main Loop 
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The control word set 
and the values saved 



in RACW by the 
for later use . 



CPU program is read 



The routine SCP is called to start the CPU output 
recovery program and call remaining copies of 1TE. 

The routine IOR is called to initialize the driver to 

recover output. 

The addresses of the terminal table entries are set 
where requested by the TTADD macro. 

The TOCA table is initialized. If a terminal is 
disabled by the CPU program, the TOCA entry for that 
terminal is set to 0FL2, and the active terminal count 
is decremented by one. If the terminal has not been 
disabled its TOCA entry is set to L6I. 

Preset checks the activation indicator in RAMD. 
Preset does not allow any lines to be activated Cthat 
is, initialization is not complete) until the 
activation indicator is set to the TCWD index for the 
stimulator driver. This is needed to control the 
activation of terminals when multiple copies of 1TE 
are ca I led . 



CTS - CHECK TELEX STATUS 

The routine CTS (check TELEX status) is used by 1TS only. CTS 
scans the PP communication area for 1TD/1TN. If 1TD/1TN is not 
found (TELEX not active), then the control point is aborted. If 
1TD/1TN is found, its message buffer is read to get the 
stimulator channel and terminal count. If no terminals are 
defined, the control point is aborted. 



ICT - INITIALIZE CONTROL TABLE 



In 1TS, ICT returns 
contr-ol word table. 



the terminal count 
On ly one ent ry i s 



read by CTS 
returned by 



to the 
ICT. 



In 1TE, ICT searches the EST for TS type equipments, assigns 
the equipment to the control point, and returns the terminal 
count to the TCWD table. The number of TCWD entries is set 
into RAPP. Routine ICT will abort the control point if no TS 
equipment is found or no terminals are defined. 



SCP - START CENTRAL PROGRAM 

The routine SCP is executed only by the 1TS or 1TE that is 
assigned to the first entry of TCWD. SCP performs the 
following functions. 



1 



Drop the CPU. 
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2. Reduce field length of control point to the minimum 
requi red . 

3. Set stimulation initiated bit in RASC and issue 
STIMULATION INITIATED message. 

4. If output is to be recovered (R0=0N), the CPU is 
started by setting the P address to STMO into the 
control point exchange package and issuing RCPM 
function. (Refer to RCO description.) 

5. Initiate 1TS or 1TE for remaining entries in TCWD 
table. 



SSL - STIMULATION SERVICE LOOP 

The routine SSL is responsible for processing all input and 
output for all active terminals. The routine RTC is called to 
process the last character input from the channel. Output 
processing is keyed off of the TOCA table. This table contains 
the address of the output routine to be used for the terminal. 
SSL calls the output routines as specified in TOCA. 



L6I - PROCESS LOGIN 

The routine LGI is responsible for activating terminals at the 
rate. speci f i ed with the AD and AC K-display directives. Once 
the line can be activated, a carriage return is output on that 
line. After all lines are activated, the activation indicator 
in RAMD is incremented by one to allow activation of terminals 
by another copy of 1TE. LGI outputs null characters until an 
initiate input prompt is received for the terminal. 



REJ - REJECT CHARACTER 

The routine REJ is used by 1TS to control the rate at which 
data is received from the host. If data is being received too 
fast, 1TS will stimulate a -character reject by the mux. 
Routine 1TD/1TN will reissue the character until it is accepted 
by 1TS. 

Routine 1TE does not require this routine since the output data 
rate is determined by the hardware being used. 



TTD - THINK TIME DELAY 

The routine TTD generates and processes a think time delay 
before the next data message is sent upline. The think time is 
generated by adding a random think time increment (set by TT 
K-display directive) to a base think time (set by TT K-display 
directive). The random think time increment is generated by 
masking the low order bits of the system clock. TTD will 
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decrement the terminal clock one every second unti the clock 
expires. The input typing speed CIS) i s • • the 
terminal clock and the TOCA table entry for the terminal is 
updated to the routine WTC. 



WTC - WRITE TERMINAL CHARACTER 




log the upline character processed. 

Special characters processed by WTC include the following. 



Character* 


Rout i ne 


ELCR 


EOL 


ELXO 


EOL 


ESC 


EOL 


ETX 


EOL 


AUTO 


SLI 


BTSK 


SNT 


ETSK 


PET 


SACN 


SAN 


OPTT 


OTY 


ESCR 


EOS 


ESXO 


EOS 



Desc ri pt i on 



li ne 

li ne 

(End of line) 

text (End of line) 

line input 



End of 

End of 

Escape 

End of 

Source 

Begi n task 

End of task 

Dynamic login character 

Opt iona I think t i me 

End of Script 

End of Script 



EOL - PROCESS END-OF-LINE 

The routine EOL is responsible for cleaning up the terminal 
table when an end-of-line is encountered. This includes 
resetting the optional think time, setting the line speed for 
downline data, clearing the user name flag, and clearing source 
line input flag. If the last line that was sent was source line 
input, the TOCA entry for the terminal is set to the routine 
TTD This allows the stimulator to send the next upline 
message without receiving an initiate input prompt. The 
routines SDC and ETM are called to log the last character sent 
and a time stamp indicating when it was sent. 



•These characters are defined in COMSSTM 
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EOS - PROCESS END OF SCRIPT 



The ro 
( ref e r 
( ref e r 
sessi o 
for a 
TTER a 
count 
to det 
the ne 
The fi 
repeat 
proces 



utine EOS is responsible for processing the repeat count 
to RC K-display directive) and Loop on session file flag 
to LF K-display directive) when the last character of a 
n has been encountered. If a repeat count is not present 
given terminal, EOS sets the terminal off line bit in the 
nd jumps to EOL to process end-of-line. If a repeat 
is present, EOS will check the loop on session file flag 
ermine if the same session should be repeated (LF=NO) or 
xt session in the TSTX table should be executed (LF=YES). 
rst word of the next session is set into the TTER and the 

count is decremented. The routine EOL i s called to 
s the end of line. 



SLI - SOURCE LINE INPUT 

The routine SLI is responsible for detecting source line input 
to the beginning of an upline message and setting the source 
line input flag in the terminal table for further processing by 
EOL. A line is considered to be source line input if the 
following conditions are met. 



1 



The first character of a line is a comma. 



2. 1TE is the stimulation driver. 



GNT - GET NEXT TASK 

The routine GNT is responsible for initiating the next best 
task. To do this the following steps are taken: 

1. The current session address and terminal status in the 
first word of TTER are saved in the third word of TTER. 

2. The next best task address is read from RANB. If the 
CPU program has not set the next best task in RANB, the 
default task is read from RATK and the task indicator 
is incremented in RASC. 

3. The task address is set in the first word of the 
terminal table entry. 

4. The task address in RANT is cleared if the default 
task was not used. 

5. The number of task call field in the task table is 
i ncremented . 



PET - PROCESS END OF TASK 

PET is responsible for incrementing the task completed counter 
in the task entry and resetting the session address saved in the 
third word of the TTER table. 
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OTT - OPTIONAL THINK TIME 

OTT converts an optional think time that is specified in the 
script into a usable format and stores it into the terminal 
table. The routine EOL will set the optional think time as the 
base think time. The optional think time will be used until the 
initial think time is reset, another optional think time is set, 
or end of script is encountered. 



SAN - SET ACCOUNT NUMBER 

The routine SAN converts the special user name character in the 
script into the first, second, or third digit of the terminal 
number. The special account number flag in TTER table is used 
to determine what terminal number digit is to be set. The 
account number field is cleared at the end of each line. 



up 
call 



RTC - READ TERMINAL CHARACTER 

The routine RTC processes the last character input from the 
channel for a given terminal. If it is a character that 
requires special processing . (such as initiate input or hang 
phone), the appropriate routine is called. If it is not a 
special character the TOCA entry for the terminal is set to 
REJ (reject character) to control the line speed. If the 
character being processed is the first output character received 
other than a line feed or null character since the last upline 
message, then ETM is called to log a time stamp for when the 
character is received. The routine SDC is called to log the 
data character. 

In addition to the above, the RTC routine in 1TE interrogates 
the first several characters of data received from the host for 
the REPEAT., message. If this message is received by a 
terminal, the routine REG is called to process the line 
regu lat i on. 



Character 

IISI* 
USE* 
REPEAT. . 



Meaning 



Routine called 



Initiate input INI 

Hang up phone HNU 

Line regulation encountered REG 



HNU - HUNG UP PHONE 

The routine HNU checks the status of the disable flag in TTER 
that the routine EOS set. If the terminal has been disabled 
(that is, no more sessions are to be processed for this line), 
then HNU will decrement the active terminal count and set the 
terminal offline by setting its TOCA entry to 0FL2. No more 
dialog will take place for this terminal. If EOS set a new 



*This symbol is defined in COMSSTM 
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session address into TTER and Left the Line enabled, then HNU 
wiLL restore the initiaL think time for the terminaL and aLLow 
the terminaL to be activated again by setting its TOCA entry to 
LGI. 



INI - INITIATE INPUT 

The routine INI is caLLed when the next upLine message is to be 
sent to the host. INI determines if the terminaL just came 
onLine by checking its TOCA entry. If it has not just come 
online, then its TOCA entry is set to jump to the routine TTD 
to proess the think time delay. If the terminaL has just come 
onLine, the first upLine message wiLL be sent immediateLy by 
setting the TOCA entry to WTC. 



REG - PROCESS REGULATION 

The 1TE routine REG is caLLed when RTC has determined that a 
Line reguLation has been encountered. REG wiLL restore the 
Location of the finaL character of the Last message into TTER. 
This address was saved in TTER by the routine WTC when the first 
character of the message was sent upLine. REG increments the 
Line reguLation counter for the terminaL in TTER and the totaL 
Line reguLation counter, a fLashing B-dispLay message is aLso 
issued to notify the operator. 

The CPU proram wiLL issue the totaL number of Line reguLations 
encountered by aLL 1TEs if the output recovery code is enabLed. 



DATA FLOW 

This section describes what happens to the K-display input that 
is entered on the session parameter dispLay. 

LINE SPEED (LS K-DISPLAY PARAMETER) 

1. The STIMULA routine SLS (set Line speed) is caLLed by 
the K-dispLay input processor to convert the Line 
speed into binary and pLace the value in Location LS. 

2. The STIMULA routine MXD (mixed parameter initiaL setup) 
moves the value in LS to the session pointer table, 
TSPT (byte 1, word 0) . 

3. The STIMULA routine MXP (mixed mode processor) may 
update the Line speed in TSPT depending on the mixed 
mode K-display input. 

4. The STIMULA routine SSA (set session address) converts 
the line speed found in TSPT to Line speed in 
characters per millisecond. This value is placed into 
the terminal table, TTER (byte 0, word 1). 
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The 1TS/1TE routine EOL (process end of tine) will set 
the data rate (byte 3, word of TTER) and with the 
line speed (from byte 0, word 1 of TTER) whenever the 
terminal is ready to accept data from the host. 

The 1TS routine REJ (reject character) checks the 
terminal clock to ensure data is not being received 
faster than the line speed specifies. If the line 
speed is exceeded, REJ will reject the character by 
sending a 1400 code to the host. 

NOTE 

The line speed for 1TE is determined by the 
hardware. The LS parameter should be set 
appropr i ately. 



INPUT SPEED (IS K-DISPLAY PARAMETER) 

1. The STIMULA routine SIS (set input speed) is called by 
the K-display input processor to set the input speed 
into the location IS. 



2. 



3. 



4. 



5. 



6. 



The STIMULA routine MXD (mixed parameter initial setup) 
moves the input speed from IS to the session pointer 
table, TSPT (byte 0, word 1). 

The STIMULA routine MXP (process mixed mode input) may 
update the input speed in TSPT depending on the mixed 
mode K-display input. 

The STIMULA routine SSA (set session addresss) 
converts the input speed in TSTP to characters per 
second. This value is set in the terminal table (byte 
1 , word 1) of TTER. 

The 1TS/1TE routine TTD (think time delay) and INI 
(initiate input) move the input speed into the data 
rate (byte 3, word of TTER) and the terminal clock 
(byte 4, word of TTER) when data is to be sent to 
that host. 

The 1TS/1TE routine WTC (write terminal character) 
checks the terminal clock to determine when the next 
character can be sent to the host. When the clock 
expires, the character is transmitted and the terminal 
clock is reset with the data rate value. 



LOGOUT 
1 



DELAY (LD K-DISPLAY DIRECTIVE) 

The STIMULA routine SLD (set logout delay) is called 
by the K-display input processors. SLD- will set the 
logout delay in the location LD. 
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2. The STIMULA routine MXD (mixed parameter initial setup) 
moves the Logout delay from LD to the session pointer 
table TSPT (word 1, byte 1). 

3. The STIMULA routine MXP (process mixed mode input) may 
update the logout delay in TSPT depending on the mixed 
mode input. 

4. The STIMULA routine SSA (set session address) moves 
the logout delay from TSPT to the terminal table (byte 
2, word 2 of TTER) . 

5. The 1TS/1TE routine HNU (hung up phone) sets the 
logout delay in the terminal clock at the end of a 
session if another session is to be processed on that 
t e rmi na I . 

6. The 1TS/1TE routine LGI (login terminal) monitors the 
terminal clock to determine when the logout delay has 
expired. The terminal is then activated. 



THINK TIME (TT K-DISPLAY PARAMETER) 

1. The STIMULA routine STT (set think time) is called by 
the K-display input processor to set the think time 
value into location TT. 

2. The STIMULA routine MXD (mixed parameter initial setup) 
moves the think time from TT into the session pointer 
table (byte 0, word of TSPT). 

3. The STIMULA routine MXP (process mixed mode input) may 
update the think time found in TSPT depending on the 
mi xed mode i nput . 

4. The STIMULA routine SSA (set session address) moves 
the think time found in TSPT to the terminal table 
(bits 31 through 24, word of TTER). The think time 
is also set in byte 3 of word 1 of TTER as the initial 
think t ime . 

5. The 1TS/1TE routine EOL (process end of line) will 
update the think time in TTER with the optional think 
time that was set by OTT (process optional think time) 
into TTER (byte 4, word 1). EOL will also reset the 
think time with the initial think time when required. 

6. The 1TS/1TE routine TTD (think time delay) computes the 
user's think time from the think time, think time 
increment, and the system clock. The user's think 
time is set into the terminal clock. TTD will monitor 
the terminal clock until it expires, at which time data 
may be sent to the host. 
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THINK TIME INCREMENT (TI K-DISPLAY PARAMETER) 



1 The STIMULA routine -TTI (set think time increment) 

sets the think time increment mask into the location 
TTI. 

2. The STIMULA routine BSM (begin stimulation) moves i the 
think time increment mask from TM to byte 2 of RACW. 

3. The routine PRS (in 1TS and 1TE) reads RACW and sets 
the think time increment mask into an LPC instruction 
in the routine TTD (process think time delay). 

4. The routine TTD reads the system clock on channel 14 
and uses the mask to generate a random think time 
increment. This value is added to the think time (as 
specified by the TT K-display directive) to produce a 
user think time. 



ACTIVATION COUNT (AC K-DISPLAY DIRECTIVE) 



2. 



3. 



he STIMULA routine SAC (set activation count) is 
ailed by the K-display input processor. SAC will 
activation count into the location AC. 



T 
c 
the 



set 



The STIMULA routine BSM (begin stimulation) moves the 
activation count from AC to byte of RACW. 

The 1TS/1TE routine PRS reads RACW and sets the 
activation count into the direct cell LC. 

The 1TS/1TE routine LGI (process login) checks the 
value of LC. If zero, no additional terminals are 
allowed to start the login sequence. If nonzero, CLC; 
is decremented by one and one terminal will proceed 
with the login sequence. Once the activation delay in 
the terminal clock expires, (LC) is incremented by one 
to let the next terminal start its login sequences. 

The maximum number of terminals that can be in the 
login sequence is equal to the activation count. 



ACTIVATION DELAY (AD K-D ISPLAY DIRECTIVE) 

1. The STIMULA routine SAD (set activation delay) is 
called by the K-display input processor to set the 
activation delay into the location AD. 

2 The STIMULA routine SSA (set session address) presets 
the terminal clock in the TTER entries with the 
activation delay. 

3. The STIMULA routine BSM (begin stimulation) moves the 
activation delay from AD to byte 3 of RASC. 
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4. The 1TS/1TE routine LGI (Login terminal) monitors the 
terminal clock. When it expires, the terminal may 
proceed with the Login sequence. 



REPEAT COUNT (RC K-DISPLAY DIRECTIVE) 

1. The STIMULA routine SRC (set repeat count) is called 
by the K-display input processor to set the repeat 
count into Location RC. 

2. The STIMULA routine MXD (mixed mode initial setup) 
moves the repeat count from RC into the session 
pointer table, TSPT (bits 23 through 19 of word 1). 

3. The STIMULA routine MXP (process mixed mode input) may 
update the repeat count in TSPT depending on the mixed 
mode i nput . 

4. The routine SSA (set session addresses) moves the 
repeat count to see if another session is to be 
processed. If so, EOS will set the script address in 
the TTER entry and decrement the repeat count. 



LOOP ON SESSION FILE (LF K-DISPLAY PARAMETER) 

1. The STIMULA routine SLF (set loop on file) is called 
by the K-display input processor to set the Loop on 
session file status into the location LF. 

2. The STIMULA routine SSA (set session address) moves the 
loop on session file status from LF to bit 59 of RASC. 
The first word address and the last word address, of the 
session text table TSTX is also set in RASC. 



The 1TS/1TE routine 
RBUF. 



PRS reads RASC into the PP buffer 



The 1TS/1TE routine EOS (process end of script) uses 
the information in RBUF to determine the address of the 
next session to be executed. If the loop flag is set, 
the next session in TSTX will be assigned to the 
terminal. If the loop flag is not set, the same 
session is repeated. The script addresses in RBUF 
(RASC) are used for table wrap around purposes. 



RECOVER OUTPUT 



(RO K-DISPLAY DIRECTIVE) 



1. The STIMULA routine SRO (set recover output) is called 
by the K-display input processor to set the recover 
output status in the location in RO. 

2. The STIMULA routines SSA (set session addresses) and 
STA (set task address) checks the recover output 
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status to compute the Location of the session and tasks 
during the stimulation when building the TASK and TTER 
tab les . 

3. The STIMULA routine, STI, calls the routine IOR 
(intialize output recover) if output is to be 
recovered. Routine IOR sets up the routines, FETs and 
buffers to be used during the stimulation in the TSCR 
table. If output is not to be recovered, TSCR will 
rema i n empty . 

4. The first copy of 1TS or 1TE called determines if 
output is to be recovered by checking the output FET 
address in its TCWD entry. If an address is present, 
the CPU program is started. This is performed by the 
routine SCP (start CPU program). 

5. The 1TS/1TE routine IOR (initialize output recovery) 
is called to initialize the PP program for output 
recovery. The routines affected are SDC (store data 
character) and ESD (end STIMOUT data). 

The following mechanism is used to recover output. 

1. The routines WTC (write terminal character) and RTC 
(read terminal character) receive the next character 
they are to process. The routine SDC (set data 
character) is called by WTC and RTC. 

2. If output is not recovered, SDC returns 
unconditionally to the calling routine. If output is 
to be recovered, word four of the TTER table entry is 
read. Byte zero of this word indicates the next byte 
to store the data character. If the word is not full, 
the data character is stored, byte is incremented, 
and the word is written back to the TTER entry. If 
the word is full, the routine SDW (set data word) is 
ca I led . 

3. SDW sets the data character into byte 4- and the 
terminal number into byte of the fourth word of the 
TTER entry. The word is then written into the output 
buffer. If the output buffer is full, the message 

LOST STIMOUT DATA 

is issued and the word is not written to the buffer. 
SDC finally clears the fourth word of the TTER entry. 

4. Time stamps are processed by the 1TS/1TE routine ETM 
(enter time stamp) by calling the routine SDC. ETM is 
called by RTC when the first character of a downline 
message is received or by WTC when an end of line is 
encountered . 
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The 1TS/1TE routine ESD (end STIMOUT data) is called 
at the end of the stimulation to flush the data stored 
in the TTER entries to the output buffer. 

The CPU routine RCO (recover output) that was started 
by SCP is constantly monitoring the amount of data in 
the output buffers. When a buffer becomes more than 
half full, CIO is called to write the data disk. One 
file will be written for each copy of 1TS or 1TE that 
i s runni ng . 

At the end of the stimulation, the CPU routine COF 
(complete output file) is called to copy all the 
stimulation output to the file STIMOUT. 



The CPU 
f i le. 



program DEMUX is called to process the STIMOUT 
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CHECKPOINT/RESTART 



25 



Checkpoint/restart is composed of two CPU routines, CHKPT and 
RESTART, which use special entry points described in section 5. 
Special entry points allow these routines to access the 
privileged file DM*. 

The user can checkpoint a program's progress for later restart by 
control statements, macro call, or RA+1 request. 

By using the RESTART control statement the user can restart a job 
from any point that was previously checkpoi nted. 

All calls and the use of these rout i nes are described in the NOS 
Reference Manual, volumes 1 and 2. 

CHECKPOINT FILE 

The checkpoint file consists of a series of checkpoint (CKP) 
records. Each checkpoint dump is separated by an EOR, a 
checkpoint control word, and another EOR. An EOI terminates the 
file. A mult icheckpoint file is formatted as follows. 



CKP1 



CKPi < 



CKPn 



header checkpoint number (CKP) 1 




data CKP1 


eor 


CKP1 control word 


trailer label 
eor 


i 


• 

• 


^ 

^ 


■ 


header CKPi 




data CKPi 


eor 


CKPi control word 


eor 


i 


• 

V 

■ • v 
• 


■* 


' 


header CKPn 






data CKPn 


eor 




CKPn control word 


eor/eoi 
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There may be one or more CKPs on the file. If two files are 
used simultaneous ly, the CKPs alternate on the files. The files 
must be requested with the CK or CB option on the REQUEST, LABEL, 
or ASSIGN control statement. 

There are five parts to each CKP dump (one large record). 

The header word 

The file table 

A copy of each of the files 

A copy of the DM* file of the requesting job 

A control word (trailer label) embedded between two EORs. 

The file is written in control word blocks, using the READW and 
WRITEW macros. Buffers are always filled before transferring to 
disk, except for the final control word. Buffers are 1000B 
words in length which is 10 disk PRUs or 1 tape PRU. Therefore, 
there are no short PRUs and no EOR, EOF, or EOIs except on the 
control word block. 

In order to indicate the EOR, EOF, and EOIs which occur in the 
data, a series of control words are used. These control words 
a re : 

1 . 10002B; header. 

2. 20nnnB; file table. 

3. 30nnnB; start of a block which contains no EOR, EOF, or 
EOIs (file copy section). 

4. 31nnnB; an EOR occurs at the end of the next nnn words. 

5. 32nnnB; an EOF occurs at the end of the next nnn words. 

6. 33000B; EOI flag. No data may occur directly before 
this f lag . 

NOTE 

The following control words 

indicate that an EOR, EOF, or EOI 

follows the nnn words of data in 
the DM* file. 

7. 40nnnB; start of a block which contains no EOR, EOF, or 
EOI (DM* file). 



8. 43nnnB; last block containing DM* file. 

9. 50000B; end of CKP dump. 
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p arh ckp dumD is one record followed by a control word re 
lach b'ock on tie file is nnn + 1 words in length, where nn 
the number of data words preceding t hi s indi cator . The m 
physical block size is 1000B words or 777B+1 words. The 
of nnn varies due to EOR, EOF, and EOI occurring in the d 
Figure 25-1 shows the format of one CKP file. 



cord, 
n is 
ax imum 
va lue 
at a . 



59 53 



47 



35 



17 



11 



FNT/FST 
entry 







10002B 











date 


time 


CKP 
mode 


CKP 
number 




job name 





20nnnB 








file name 1 


jo 


file 
type 


copy 
type 


id 


eq 


first track 


cri 


stat 


■*% 






• 
• 









- header 



■ file table 



> 



FNT/FST 
entry 



file name n 



jo 



id 



eq 



first track 



cri 



file 
type 



copy 
type 



stat 



30nnnB 



file 1 data 



EOR flag 31nnnB 



nnn data words 



EOI flag 33000B 



30nnnB 



file 2 data 



EOF flag 32nnnB 



nnn data words 



EOI flag 33000B 



30nnnB 



i 



file n data 



copy of files 
requested in 
I, order of the 
file table-, 
may be many 
blocks of data 



33000B 



dump file 40nnnB 



contents of the DM* file 



date 



50000B 



time 



CKP 
mode 



CKP 
number 



end of CKP(eor) file 

control word similar 
to word 1 of header 



Figure 25-1 . CKP Format 
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date 
time 
CKP mode 

CKP number 

j obname 

f i Lename 

jo 

file type 

copy type 



id* 
eq* 
first track* 

c ri 

stat* 
nnn 



Date CKP record was written. 

Time CKP record was written. 

Indicates whether the CKP file is sequential 
(CK) or overwrite (CB) type. 

Sequential number of this CKP. Equals 1 
after first CKP, 2 after second, and so on. 

Name of job requesting CKP. 

Name of file to be checkpoi nted. 

Job origin or access bits from FNT. 

FNT file type (INFT, LOFT, for example). 

Type of copy to perform. Unless otherwise 
specified by the user, files are copied 
according to their position and type of 
operation (read or write) prior to the CKP 
request. The copy types are: 

BOI to present position 

1 Present position to EOI 

2 BOI to EOI 

3 Last operation on file determines 
the copy type 

4 No copy of file on CKP file, but 
information table is present 

FST id code. 

FST equipment number. 

FST first track if mass storage; 
if tape, MT; if terminal file, TT. 

Current random index. If tape file, cri is 
the block number. If terminal file, cri is 

Last status from the FET. 

Number of words in this block (not including 
this word) . 

Bit 59 set if this is the last CKP dump on 
the file and is followed by an EOI PRU. 



Figure 25-1 



CKP Format (Continued) 



♦Standard FST information (except MT and TT for first track) 



Figure 25-2 illustrates how the checkpoint file looks assuming a 
job has the following characteristics: 

• FL = 2600B, control point area = 200B. So DM* file 
consists of 200 (CPA) + 2600 (FL) = 3000B 

wo rds . 

• Two files imply 4 words of FNT/FST information. 

File 1 consists of: BOI, 1500B words, EOR, 1 00B 

words, EOF, 2001B words, EOR, 
170B words, EOR, EOF, EOI. 

File 2 consists of: BOI, 100B words, EOR, 1000B words, 

EOR, EOI. 

• Assume this is a nonterminal job. 



Block 



1 



10002 



CKP#1 



jobname 



20004 



file 1 FNT 



FST 



file 2 FNT 



FST 



30767 



data 



-start of- 
file 1 



31511 



data 



32100 



data 



30164 



data 



(All values are in octal) 





3 


- indicates 


30777 


EOR follows 




511th word. 




- indicates 




EOF follows 




100th word. 






data 


no EOR or 




EOF in 




this block. 





31616 



data 



30160 



data 



31010 



data 



32000 



33000 



31100 



data 



30663 



data 



- start of 
file 2 



DM* file is identical to standard rollout file. Refer to 
section 5 for DM* file format. 



Figure 25-2. Checkpoint File Structure 
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31115 



data 



33000 



40660 



data 



40255 



-start of 
DM* file 
(CPA) 

start of 
FL 








43122 



data 



50000 



CKP#1 



10002 



CKP#2 



etc. 



- last block containing 
-v DM* file 

\-end of CKP dump 



-end of CKP dump 
-EOR 

-EOR 



Figure 25-2. Checkpoint File Structure (Continued) 
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CHECKPOINT - CKP 

fHKPT is a CPU routine which must reside either in the RCL or be 

CHKPT ls .; a l u "; .' vstem) CHKPT can be initiated either by 

Hisk resident CCLD sysieni^ u n ix ■ ■ 

ens* resiucm. v ' ftntPO i statement ca , a macro call, or 

an operator command, a control s" iemcn ^ ' 

by a product set call (refer to figure 25-3). 

CHKPT has special entry point status (refer to sections). 
CHKPT uses the following special entry points: D-HP-, SSJ-, and 
RFL=. 

ii j u ~ „««■»■ r.«i ctafpment- 1AJ determines that 
t f rwKPT is called by a control siaiement/ ■"* 

°h H .r.n ss", and I DIP- special entry point ro. in, 
se ts up SPC«, "PW and t e contro po n = a ea «out,ne e 1R0 ol s 

11 oln^HKPT 3 III of the o^fie d tengt. is saved on DM*. 

ine 1a7 U^es tne argents fr.. th. control .t.««.nt into 
RA+ARGR and sets RA + P6NR accordingly during the load of chkm. 
Then control is passed to CHKPT. 

If CHKPT is called by a macro, an RA + 1 request is made t0 CHKPT. 
This request is handled by SFP, an entry point in CHKPT. 

If CKP is called via a product set, such as FORTRAN or COBOL, 
an RA+1 request is made and the parameter list, f one is 
specified, is set up the same as in the macro call. 

The RA+1 request is processed by CPUMTR, which places the call 
into the IR of an available PP. 



59 



IR 



CKP 



41 35 29 



cp no. 



± 



17 



pbo 



n Number of parameters 
pba FWA of parameter block 
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© 



CHKPT 



CHECKPOINT -Snapshot \ 
CHECKPOINT - Snapshot 
CHECKPOINT -Snapshot 



CHKPT 
file 



(2) Make CKP request 
CHKPT - DMP = 



RA+1 



*1 



program 



call 
CHKPT 



Program 
makes 
call to 
CHKPT 




(3) CHKPT running in users 

^^ FL creates record on CKP file 




DM* 










CHKPT 
file 







(4) When CHKPT ends 1AJ calls 1RI 

^"^ in response to DMP= SEP and user continues 



f 1AJ Y-*/lRI J 



FL 




users 

job 

restored 




DM* 











*"1 Creates an RA + 1 call. 

Figure 25-3. Checkpoint Overview 
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Since PP resident does not find CKP in either the RPL or in the 
PLD, it calls SFP. 

SFP finds CKP as one of its special processors. The SFP overlay 
2SG (SRP - spcial request processor) sets up SPCW from the IR. 



SPCW 




SFP exits 
which has 
noncont ro 
has been 

Routine 1 
block fro 
DM* file 
RA+SSPR+2 
i ndi cated 
special p 
cont rol t 
20B-word 
CHKPT has 



normally and 1AJ finds SPCW set. It loads CHKPT, 
the entry point CKP, and sets RA+PGNR=0 to indicate a 

I statement call. Since a DMP = special entry point 

indicated in the CLD, 1AJ calls 1R0. 

RO finds the pba not equal to zero and gets a 20B-word 
m central memory whose fwa is pba. It creates a full 
and then stores the 20B word block in RA+SSPR+1 through 
0. Routine 1AJ sets up SEPW %nd any priorities 

by the SSJ= (in the case of CHKPT, there are no 
riorities), stores the IR in RA+SSPR, and passes 
o CHKPT at the entry point CKP. If more than a 
parameter is passed (CHKPT can be passed up to 200), 

to read it from the central memory portion of DM*. 



The preset routine in CHKPT is overlayed by the buffers, since 
its origin is at IBUF. In addition, RFL= is equated to the last 
word of CHKPT, which is necessary to use the SSJ= entry point. 

Tables 25-1 and 25-2 list some of the common decks used and the 
buffer assignments. 

Figures 25-4 and 25-5 are flowcharts detailing the CHKPT main 
loop and preset routine. 
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HDR 



I 



WRT 



CPF 



write header 
onto CKP 
file 



1 



set file name 

in 
FET to DM* 



REWIND 
DM* 



BLO 



copy DM* file 
to CKP file 



write file 

TABLE onto 

CKP file 



copy desired 
files to 
CKP file 



place 50000B 
in buffer 



WRITER 
CKP file 



1 



place 

CKP control 

word in 

buffer 



WRITER 
CKP file 



set completion 

bit in 
parameter table 



return 

control 

statement 

file 



CHECKPOINT 
COMPLETE 



*5 



f end J 



• 1 
*2 

*3 

• 4 
*5 

• 6 



Wait for any I/O initiated by PRS to complete. 

Use GETFNT macro which calls LFM to return a list of all 

FNT/FSTs assigned to this control point. 

Refer to DMP= in section 5. Format of DM* file is control 

point area, job field length. Copy complete DM* file. 

Copy of header word. 

Now CKP control word is embedded in EORs. 

SPRR+1 also backspaces file so trailer can be read by next 

CKP call. 



Figure 25-4. CKP - Checkpoint Main Loop 
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process 

parameter 

list 



set selective 
CKP flag 
RA+SPFL = n 




■WPRS1 




-HPRS2 



*3 



SKIPEI DM* 




yes 



read last record 



I 



process 

rest of 

parameter list 




*1 
*2 
• 3 

*4 
*5 



Is (RA+PGNR) not equal zero? 

Is (RA+SPPR) Lower 18 bits (that is, n from IR) not equal 0? 
Parameters = file names are placed in block PAR for use by 
WRT and CPF to get just selected files onto CKP file- 
Is n > 20? 
Only 77B parameters are allowed. 

Figure 25-5. PRS - Checkpoint Preset 



60454300 A 



25-11 




PRS2 




set selective 

CKP flag 
RA+SPFL=n 



process 
parameter 
list 



CKP request 



no ^pr S 




preset all pointers 



get control 
statement file 




*1 Is RA+ACTR not equal zero? 

*2 Maximum 63B parameters on a control statement. 

Figure 25-5. PRS - Checkpoint Preset (Continued) 
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get list of all 
FNTs assigned 

to this 
control point 






1 no 




create default file 
CCCCCCC 


* 


set 


ID = CK 




I 


C 


return 


) 



get proper CKP 
file set up for write 
and position file. 
Set FETs up. 



return 



CHECKPOINT 
ERROR 



J f abort J 



•1 See if any files Local to job have type CK or CB. 

Figure 25-5. PRS - Checkpoint Preset (Continued) 
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TABLE 25-1. CHKPT COMMON DECKS 



Load 
Address 



Common Deck 



Desc ri pt i on 



724 

736 

752 

756 

776 

1006 

1070 

1114 

1245 

1255 

1314 

1331 



COMCCDD 

COMCCIO 
COMCCPM 
COMCDXB 
COMCLFM 
COMCMVE 
COMCRDO 
COMCRDW 
COMCSFN 
COMCSYS 
COMCWTO 
COMCWTW 



Constant to decimal display code 
conve rs i on 

I/O function processor 

Control point manager processor 

Display code to binary conversion 

Local file manager processor 

Move block of data 

Read one word 

Read words to working buffer 

Space fill right justified zeroes 

Process system request 

Write one wo rd 

Write words from working buffer 



TABLE 25-2. BUFFER ASSIGNMENTS 



Load 
Address 



Buffer 



Leng t h 



1454 
2454 
4455 
6456 
7057 
10060 



BUF 

IBUF 

OBUF 

SBUF 

TBUF 

RFL = 



Start of buffers 

BUF+BUFL 

IBUF+IBUFL 

OBUF+OBUFL 

SBUF+SBUFL 

TBUF+TBUFL 
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RESTART 



RESTART 

be di sk 

RESTART restores 

file and causes 1RI 

from the DM* file. 



is a CPU routine wich must reside either in the RCL 
resident (CLD). Whereas CHKPT writes the Mil, 
the contents of the files copied to the CKP 

to restore the control point area and FL 

(Refer to figure 25-6.) 



or 



RESTART has the special entry point DMP=. 

RE: 

o 

c 

it creates an empty 



When 1AJ 



loads 
from 



the CLD 



E^^/i; n.t«th.t.p..1.l. ntr, point 1. : .ti«,rro.. clu 
?e R ates en a t O^ P ?U t e. WO stn:: t D H p: t is 9 erua;ed I t o 450000R in RESTART, 



DM* file. 



(T) RESTART is a control 
^-^ statement call 




FL 



Load RESTART into users FL 



Fgiure 25-6. RESTART Overview 
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© 



RESTART builds 
DM-* file from 
CHKPT file 



FL 






TUIWDT 


RESTART 




file 




DM* 




















(?) RESTART ends and 
1AJ responds to 
DMP=SEP 



FL 



*1 



program 



MJ Execution begins at next 
^""^ instruction after the call 
to CHKPT. 

FL 



program 



call CHKPT 



* 1 This is the same area as RESTART of step 2 . 

Figure 25-6. RESTART Overview (Continued) 
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Routine 1AJ sets up the control point area (SEPW, and so on). 
Loads RESTART, stores the argument List in RA+ARGR, sets RA+ACTR 
accordingly, and initiates RESTART. RESTART cannot be called 
from an RA+1 request, so the parameter passing ability of DMP = 
is not utilized. RESTART locates the proper CKP file, requests 
the FL required, restores the files required (including the DM* 
file from the CKP file), and exits. 

Routine 1AJ then finds the control point idle and notes that 
this was a DMP= run. It calls 1RI, which rolls the job in using 
the DM* file created by RESTART. When 1RI is done, it clears 
the rollout flag, and the job is restarted from its position 
immediately following the checkpoint. 



As in CHKPT, the preset routine is used as a buffer so that 
length is minimized. Tables 25-3 and 25-4 list some of the 
common decks used and the buffer assignments. 



field 



Figures 25-7 and 25-8 are flowcharts detailing the RESTART main 
Loop and preset routine. 
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TABLE 25-3, RESTART COMMON DECKS 



Load 
Address 



Common Deck 



Desc ri pt i on 



614 
640 

653 

667 

673 

713 

736 

746 

756 

771 

1014 

1145 

1155 

1214 

1231 



COMCARG 
COMCCDD 

COMCCIO 
COMCCPM 
COMCDXB 
COMCEDT 
COMCLFM 
COMCPFM 
COMCRDC 
COMCRDO 
COMCRDW 
COMCSFN 
COMCSYS 
COMCWTO 
COMCWTW 



Process arguments 

Constant to decimal display code 
convers ion 

I/O function processor 

Control point manager processor 

Display code to binary conversion 

Edit date or time from packed format 

Local file manager processor 

Permanant file processor 

ft 

Read coded line, -C- format 

Read one word 

Read words to working buffer 

Space fill name right justified zeroes 

Process system request 

Write one word 

Write words from working buffer 



TABLE 25-4. RESTART BUFFER ASSIGNMENTS 



Load 








Address 


Buffer 


Length 










1470 


BUF 


Start of buffers 




2471 


IBUF 


BUF+BUFL 




4472 


OBUF 


IBUF+IBUFL 




6473 


SBUF 


OBUF+OBUFL 


* 


7074 


TBUF 


SBUF+SBUFL 




10103 


RFL = 


TBUF+TBUFL+4 
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get DM* file 



rewind 
DM* file 



L 



*2 



get memory 
from CPA 
on CKP file 





V 




request 
central memory 




v. 




copy rest of 

CKP file to 

DM* file 




\ 


r 




position CKP 
file for 
subsequent 
CKP 




i 




RESTART 
from *jobname 
date and 
time* 









*6 



*1 
*2 
*3 

*4 

*5 
*6 



Copy all data files from the CKP file. 

Prepare to write remainder of CKP file onto the DM* file. 

Exchange package in first 20B of control point area and word 

CPA+2 is FL. 

If job card FL request is less than FL needed to RESTART, 

control point would be aborted by CPUMTR. 

Stop on EOR. 

Message set up by preset. 

Figure 25-7. RESTART - Restart Main Loop 
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ERROR 
IN 
ARGUMENTS 



set CKP 
file name 

into 
INPUT FET 



abort 




set CKNO = 
RA+ARGR+1 



process argument 

common deck 

COMCARG 




ARG 



/^RSN 



get proper 
CKP on file 
from CKNO 



position 
CKP file 



get 
jobname 



place data and 
time into mes- 
sages issued at 
end of run 



C 



return 





/PRS\ 



*1 Is (RA+ACTR) not equal zero. 

*2 RESTART must have an argument List (checkpoint file name) 

*3 Is (RA+ARGR)=0. 

*4 (RA+ARGR)=CKP file name. 

*5 Is (RA+ARGR+1 )=0. Note that CKNO 

*6 Is (RA+ARGR+2)=0. 

*7 The error CHECKPOINT FILE ERROR if header word 

CHECKPOINT NOT FOUND if asked for a CKP number 

the f i le. 



is preset to at assembly. 



missing 
that is 



or 
not 



on 



Figure 25-8. PRS - Restart Preset 
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DEADSTART 



26 



Deadstart is the process by which the system is made operational 
and ready to process jobs. Under normal, circumstances, a 
deadstart is a function performed by the system operator. System 
deadstart can be a fully automatic procedure or it can involve 
considerable operator intervention. 

The deadstart file is either a reel of magnetic tape, written in 
unlabeled I format, or an 844/885 disk device containing the 
programs which constitute the NOS operating system and its 
product set members. In addition, the deadstart file contains 
programs necessary to establish the system and its product set on 
the system equipment as well as maintenance routines used to test 
the condition of certain system equipments. As the deadstart 
file is not dependent upon a specific equipment configuration, 
the same file can be used on any supported equipment 
conf igurat ion. 

To load the NOS operating system into a CDC CYBER 170, CYBER 70, 
or 6000 series computer, the deadstart medium is mounted, and a 
small bootstrap loader program (deadstart program) is set up on 
the hardware deadstart panel switches. The deadstart procedures 
themselves are explained in the NOS Operator's Guide. 



HARDWARE DEADSTART 

When the operator presses the deadstart button or toggles the 
deadstart switch on the deadstart panel, the following hardware 
activities occur: 

1. Each channel is connected to its corresponding PP (that 
is, channel 1 is connected to PP1 , channel 2 to PP2, and 
so on) . 

2. A master clear is done on all 1/0 channels. All channels 
are set to the active and empty condition, ready to 
accept i nput s . 

3. The contents of the A register of each PP is set to 
10000B so that a PP can input its entire field length 
before automatically disconnecting from the channel. 
The P register of each PP is cleared. 

4. The deadstart panel is sent across channel into PP0 
locations 1 through 20 (locations 1 through 14 on 
non-CYBER 170 equipment). 

The deadstart controller outputs one byte of zeros and 
the panel settings to PP0. It then issues a DCN 
instruction and PP0 begins execution at location 
(P)+1 =0+1=1. 
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5. Each PP simulates an IAM instruction on its channel as 
the contents of PP locations through 4 were: 



i f 



location 


1 
2 
3 
4 



value 

0000 
2001 
0000 
71pp 
0000 



comments 

start at location 
set A register to 



P + 1 = 1 
10000B 



IAM pp; pp is PP number (channel) 
location to input data (location 
0) 



6. The CPU initiates a hardware idle. 



When 

12-b 

deer 

disc 

s tor 

p roc 

word 

one 

exec 

or a 

hard 

wish 

wi I I 

t ran 

begi 



the 
it PP 
ement 
onnec 
es (0 
edure 
s and 
into 
ut ion 
not he 
wa re, 
es to 

exec 
smi tt 
ns ex 



IAM begins, (P) +1 is stored in location zero. As each 

word is transmitted across the channel, (A) is 
ed by one. Whenever (A) is or the channel is 
ted by another PP or a controller, the receiving PP 
)+1 into P and execution begins at that location. This 
is used to autoload routines. A PP will IAM a set of 
then input as the final word an execution address minus 
location zero. The PP then begins executing at the 

address specified. PPs may communicate with hardware 
r PP via a channel. If a PP communicates with some 
it must set its A register to the number of words it 
input. When this number of words has been input, it 
ute at (0)+1. If two PPs are communicating when the 
ing PP does a DCN on the channel, the receiving PP 
ecution as if A went to zero. 



SOFTWARE DEADSTART 



STARTUP 

When the hardware is ready, PP0 begins executing the program on 
the deadstart panel. The following operations are performed: 

1. PP0 disconnects the deadstart channel, then reconnects 
(via function) to the channel, equipment, and unit 
specified in the panel settings, and rewinds the 
deadstart device. PP0 then reads the first record from 
the deadstart medium into its memory starting at location 
7301B (also specified on the panel). 
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The deadstart file has a fixed order through the routine SYSEDIT. 
Included in this ordering are zero Length records which delineate 
certain areas of the deadstart file so that the logic for reading 
the file is as simple as possible during the deadstart sequence. 



OSB 

Routine OSB is the operating system bootstrap which is loaded by 
CTI into PPO as the system file preloader. OSB contains a tape 
and disk driver and must be no longer than one disk sector in 
length including the prefix (7700) table. The only function of 
OSB is to load the next operating system module, DIO, from the 
deadstart medium. DIO is transmitted to PP10 along with 
deadstart parameters determined by CTI, after which OSB hangs on 
an IAM waiting to input SET on channel 10. 



DIO 

DIO is 
medi urn 
deadst 
read . 
RMS in 
via an 
resemb 
PP10 f 
equi pm 
i nterc 
deadst 



the 
/ ei 
art- 

Thu 
to a 

int 
li ng 
unct 
ent 
ommu 
art 



cen 
ther 
rela 

s, 1 

f ac 
erco 
• tha 
ions 
and 
n i ca 
medi 



tral 
tap 
ted 
OB d 
s imi 
mmun 
t of 

as 
retu 
t ion 
urn i 



ized means of reading data from the deadstart 
e or disk. This allows the other 
routines to remain unaware of the medium being 
isk sectors are assembled if deadstart is from 
le of a tape PRU. Commands are issued to DIO 
ications channel according to a protocol 

a 3000 type tape controller and 6681 . DIO in 
the 6681, reading data from an external 
rning the same to the requesting PP. The 
s channel is defined as channel 13 unless the 
s there, in which case channel 12 is used. 



DIO initially loads SET and transmits it to PPO. Next, the 
deadstart parameters as found by CTI are transferred to PPO and 
SET begins execution. DIO now drops into an idle loop awaiting 
function requests on the intercommunications channel. 

DIO remains active until such time as the deadstart file is 
normally rewound. In the case of level 1 or 3 deadstarts, where 
the running system file(s) is recovered, this occurs after the 
deadstart RPL has been built. On a level or 2 deadstart, DIO 
functions until SYSEDIT is loaded. Then DIO may exit to PP 
resident to become a pool processor. The deadstart file is 
copied to SYSEDIT's buffer either by DIO or CIO, depending on 
the deadstart medium. 



SET 

SET initializes the system configuration by assembling system 

parameters such as equipment definitions and installation options 

from text decks that are present on the deadstart tape; namely, 
the CMRDECK which defines the configuration, and the IPRDECK 

which specifies installation options. SET communicates with PP10 
as f o I lows : 
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When SET begins execution in PPO, PP1 is waiting for 
input on channel 1*. SET transmits via channel 1* an 
idler program to PP1 and disconnects channel 1*. 



PP1 begins executing the idler program. Besides an 
loop, the idler program consists of the following 
p rocesso rs : 



idle 



Value 



Name 






RSP 


1 


IFB 


2 


ISB 


3 


OFB 


4 


OSB 


5 


ONL 


6 


RCL 


7 


ANL 


10 


ADS 



Comments 

Reset PP/terminate 

Input first buffer from tape 

Input second buffer from tape 

Output first buffer to SET 

Output second buffer to SET 

Output next line to SET 

Replace current line 

Add next line to PP1 buffer 

Advance display 



SET uses channel 10 to display the CMRDECK/ IPRDECK and 
CMRINST/IPRINST on the display console. SET also accepts 
operator typeins via channel 10. 

SET uses PP1 as a CMRDECK/ IPRDECK buffer while building 
the appropriate DECK from operator input, if any. 

SET communicates with PP1 via channel 1*. PP1 gets the 
appropriate CMRDECK/ IPRDECK from the deadstart medium via 
the intercommunications channel and DIO in PP10. 

When SET completes CMRDECK and IPRDECK processing, it 
issues the RSP function to PP1 via channel 1*. 

PP1 loops waiting for input on channel 1*. 



*If the deadstart medium is on channel 1, channel 12 is used. 
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SET initializes the system in the following sequence: 



1- SET determines the properties of the hardware upon which 
the system is being established from the hardware 
descriptor table created by CTI. These properties 
include central memory size, number of PPs, presence of 
CMU and CEJ/MEJ, type of CPU and hardware, and so forth. 
Certain of these hardware features may be overridden by 
CMRDECK entries. 

2. SET loads overlay CMR (next record on the deadstart 
file), which has the code to process CMRDECK entries; 
reads up the text deck CMRINST (CMRDECK instructions, the 
next record on the file); and reads the specified 
CMRDECK. 



3. CMR displays via PP1 the CMRINST or CMRDECK decks and 
accepts input from the console. When the CMRDECK is 
changed to the operator's satisfaction, CMR skips all 
text records (CMRDECKs) on the file and loads the next 
nontext record (which must be ICM) as a secondary 
overlay. 

4. Initialize central memory (ICM), returns control to SET 
after building the following central memory resident 
tab les : 

Channel release table 

Equipment status table (EST) 

File name table CFNT) 

FNT interlock table 

Mass storage tables (MST/TRT) 

Job control area 

Control point areas 

Dayf i le poi nters 

PP communication area (initialization) 

The first five entries in the FNT are: 

SYSTEM 

VALIDUs 

SALVARE 

RSXDid 

RSXVid 

5. SET loads the next record, IPR, from the deadstart 
medium. 

6. SET reads IPRINST (IPRDECK instructions, the next record 
on the deadstart file) and the specified IPRDECK, 
displays them, and accepts console input if the last 
CMRDECK typein was the command NEXT. If the last CMRDECK 
command was GO, the specified IPRDECK is read and no 
input is accepted. IPR sets the appropriate portions of 
central memory resident (IPRL, job control area, etc.) as 
specified by the options in the IPRDECK or by operator 
typein. Control is returned to SET when IPR has 
completed. 
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7. 



SET scan 
PP res i d 
buffer. 
SET then 
mi nus on 
Locat ion 
system t 
then tra 
st art i ng 
t ermi nat 
begin ex 
to wait 



s all remaining text records (IPRDECKs) and loads 

ent (the first nontext record), into its PP 

SET sets the location of its PP buffer to PPFW-1 . 

transmits the buffer starting at PP buffer 
e into PP2 on channel 2*. This puts PPFW-1 into 

of PP2. SET reads the next deadstart record, 
ape loader (STL), into the same PP buffer. SET 
nsmits this buffer to PP2. PP2 inputs STL 

at location PPFW. SET disconnects channel 2*, 
ing the input of STL by PP2 and causing PP2 to 
ecution at PPFW. SET (PPO) then issues an IAM 
for input on channel 0*. 



SYSTEM LOADING 

The system tape loader (STL), processes the next group of records 

on the deadstart file. STL loads MTR and CPUMTR and enough of 

the system routines to allow recovery and SYSEDIT to function. 

The following sequence is performed. 

1. Load a copy of PPR to all PPs except and 1. 

2. Load MTR (next record on tape) into PPO. 

3. Load and initialize CPUMTR; start CPUMTR into execution 
via an EXN instruction. 

4 . Load DSD into PP1 . 

5. Disconnect channel 0*; this causes MTR in PPO to begin 
execut i on . 

6. Load RSL as an overlay to STL to generate the resident 
peripheral library (RPL) and peripheral library 
directory (PLD) containing those PP routines used 
during deadstart . 

7. Activate other PPs by disconnectingtheir channels, 
causing the code transmitted in step 1 to be executed. 

8. Load controlware for 7054/7154/7155 controllers. BCL 
reads the BCS/BCF/FMD controlware records from the 
deadstart medium and outputs the appropriate record on 
channels that have 7x5x controllers. The entire 
controlware block is sent one channel at a time until 
all 7x5x controllers have been properly loaded. 

9. Load recover mass storage (RMS) into the next available 
PP (usually PP3). 

10. Load system library loader (SLL) into the next available 
PP (usually PP4), if the system file is to be loaded 
(level or 2 recovery). 



*If deadstart medium is on this channel, channel 12 is used 
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11 

12 



13, 

14 
15 

16 



17 



Load LSL (load system Library) as an overlay to STL 
if level or 2 deadstart (not on level 1 and 3). 

LSL moves the PP assignment to the deadstart control 
point (control point 1) using CCAM. The deadstart 
control point exchange package and control point area 
are initialized; the FL used is the remainder of the 
available machine field length up to 131K. 

LSL sets up an INPUT file FNT so that the deadstart 
control point resembles a control point in the running 
system. 



LSL creates 
disk. 



a deadstart file FNT if deadstart is from 



LSL loads SYSEDIT from the deadstart file into the 
deadstart control point field length and requests the 
CPU via an RCPM to begin SYSEDIT execution. 

LSL calls DIO with a load system request and then 
returns to the main program of STL if level or 2 
deadstart (not on level 1 and 3). STL moves to the 
system control point via a CCAM and drops the PP with 
DPPM. 

SYSEDIT reads the deadstart file (using DIO if tape 
deadstart, or CIO if disk deadstart) and copies the 
data to each system device defined using SLL. SLL 
guarantees that each copy of the system uses the same 
tracks. 



SYSEDIT 

SYSEDIT begins to build CM and mass storage library directories 
when the end-of-file on the deadstart file is detected. The 
following steps are performed. 

1. Reading from the first system device, the resident 
peripheral library (RPL) is built by SYSEDIT and copied 
to central memory by SLL. The routines are entered in 
the RPL without their 77 (prefix) tables. 

2. A PPULIB file without prefix tables is built on each 
system device of all PP routines. The peripheral library 
directory (PLD) is built consisting of the name and 
residence location of the routine whether it be central 
resident, on an ASR device, or on a SYSTEM device. 
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The resident central Library (RCL) is built using those 
CPU routines selected for central memory residency in the 
LIB DECK via the *CM directive. 

The central library directory is then built for all CPU 
routines and consists of the routine name and residence 
location of the routine whether it be central resident, 
on an ASR device, or on a SYSTEM device. 



5. SYSEDIT completes its execution via an ENDRUN macro, 
this point, the operating system has been fully 
established on the system equipment. 



At 



SYSEDIT may also be run on-line during normal production. If a 
SYSEDIT is run beyond deadstart, then any new or replaced CP or 
PP routines, libraries, etc., are written starting at the end of 
the system file. The RPL, PLD, RCL, and CLD are regenerated 
using these new or replacement routines as necessary. 

During deadstart SYSEDIT uses the LIBDECK specified by the 
CMRDECK directive from the system file to determine the 
residency and special properties of system routines. Each 
subsequent SYSEDIT operation appends the directives used to the 
LIBDECK initially used during deadstart. These LIBDECKs are 
linked together so that SYSEDIT can recreate the directories from 
any earlier time if directed to do so by a SYSEDIT(R=n) 
res to rat ion. 



MS RECOVERY OPERATIONS 

Mass storage recovery takes place in the PPs. The deadstart 
portion of mass storage recovery is briefly described here; mass 
storage recovery is presented in detail elsewhere in this manual. 

Recover mass storage (RMS), which was called by STL, performs 
mass storage recovery in the following sequence: 

1. Reads MSTs from device labels. 

2. Recovers TRTs when possible. 

3. Validates and recovers system dayfiles. 

4. Validates and recovers preserved files. 

5. Validates the permanent file configuration. 

6. Loads the system recovery processor CREC), into this PP. 
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REC performs system recovery in the following sequence: 

1. Reads system tables. 

2. Recovers FNT, control points, and so forth. 

3. Initializes or activates dayfiles. 

4. Waits for SYSEDIT/SLL to complete. The SYSTEM file FST 
is set not-busy when SYSEDIT completes. 

5. Builds IQFT (level deadstart only) from queue type 
files found on the disk and clears all direct access 
file interlocks. 

6. Issues appropriate dayfile messages. 

7. Re covers /allocates user ECS area. 

8. Calls 1CK to checkpoint system devices (always on a 
leve I deadstart) . 

9. Drops the PP via DPPM. 

DSD, which was earlier activated by STL, processes the IPRDECK 
initial commands (AUTO, and MAI., for example) specified by the 
DSD di rect i ves. 

The scheduler (1SJ) finds that control point 1 (the deadstart 
control point) now has a status of and releases the control 
point. Since there is no output, no output or dayfile messages 
are i ssued. 

The system is now fully operational. 



PPR INITIALIZATION 

When STL sends a copy of PPR (PP Resident) to each pool PP, the 
direct cells IA, OA, and MA are set with the correct addresses 
for the PP being loaded. When STL disconnects the channel, each 
PP begins executing at PRS which is the resident initialization 
routine (preset). PRS is at location MSFW and is overlayed by 
the mass storage driver. PRS performs the following: 

1. Reads PPCP, the first word address of the PP 
communication area. 

2. Reads IA, which is the address of this PP's IR. 

3. Computes the exchange package addresses for this PP 
from the PP's IR. 
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4. Modifies instructions in FTN (function processor) with 
the exchange package address. 

5. Modifies instructions in FTN depending upon the 
existence of CEJ/MEJ. 

6. Jumps to PPR (idle Loop) making the PP a pool PP. 



RECOVERY 

Deadstart recovery is an inhibition of part of the deadstart 
process. No special routines or special code is designed for 
different levels of recovery. The philosophy is that deadstart 
is always a recovery and the levels of deadstart only denote how 
much to recover and how much to reload. The various levels of 
deadstart recovery are discussed in detail in the NOS Operator's 
Guide. Mass storage recovery is detailed elsewhere in this 
manua I . 

Basically, there are four recovery (deadstart) options: 



Level Description 

All of central memory resident, all of the system, and 
all PPs are reloaded. Permanent files and dayfiles are 
recovered from the labels of the mass storage devices if 
possible. Job queues are restored depending on the 
QPROTECT option. 

1 A level 1 recovery rebuilds the running system, all jobs, 
and all active files from the checkpoint file instead 

of the deadstart tape. A deadstart automatically 
creates a checkpoint file as part of the deadstart 
process. The FNT is recovered from the checkpoint file 
with central memory resident rebuilt and all PPs 
reloaded. Mass storage is recovered from the MST/TRT 
image written on the label track by a device checkpoint 
which was done when the system was chec kpoi nt ed . 

2 A level 2 deadstart is the same as a level 1 recovery 
except that the operating system is loaded from the 
deadstart file rather than from the checkpoint file. 

3 A level 3 recovery only reloads the PPs and CPUMTR; 
everything else is left intact. Level 3 reloads 
directories from the system table file. This voids any 
on-line SYSEDITs that were not completed with a system 
checkpoint. Jobs currently in central memory may be rerun 
with the INPUT file being rewound and placed back into 
the INPUT queue. 
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CHECKPOINT FILE 

The system table file, usually called the checkpoint file, is 
used in level 1, 2 and 3 recoveries- The first track of this 
file is kept in byte 3 of the DULL entry in the MST for system 
devices- It contains a copy of central memory resident; namely, 
the low core pointers, the EST, the FNT, the dayf i le buffers and 
their pointers, and from the beginning of the RPL to the end of 
central memory resident. Except for the system checkpoint done 
during the deadstart process, a system checkpoint should be 
followed by a level 1 or level 2 deadstart. To continue system 
operations after a system checkpoint jeopardizes the success of 
subsequent level 1 or 2 recovery. 



DISK DEADSTART FILE 



In order to deadstart from disk, it is necessary to create a 
system deadstart file (SDF) on a disk device. The two routines, 

tuctai i -»^^ 1tc 1 1 h A r- V\ f r\ n +■ n r\ \ + h n c f imrtinn aro Hn criifiCPrl 




INSTALL 

This CPU routine works in conjunction with the PP program 1 1 S to 
install a SDF on a RMS deadstart device. The install procedure 
can be initiated automatically at deadstart by keying in the 
INSTALL directive at CMRDECK time, or else as a control 
statement issued by a system origin job. The result is a 
preserved LIFT type file, with pointers to it set in the 
deadstart sector. 

The format of the control statement is as follows. 

INSTALL, lfn,EQxx. 

Ifn Name of the install file. 

xx Logical equipment number of the device to 
receive Ifn as a SDF. 

If the Ifn parameter is omitted, default is to file SYSTEM, 
which must be attached to the control point. An install file 
named SDF is illegal as this is the name reserved for the SDF. 
special form of the control statement, without parameters is 
issued by LIS if the job was invoked during the deadstart 
process. Any error encountered during parameter checking aborts 
the job with the following message. 

INSTALL - ARGUMENT ERROR. 
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ng parameters, INSTALL issues a 1 1 S request 

to validate the install file, and then reads the 
cord and verifies it for proper format. The install 
side on mass storage. If a user wishes to install a 
t must first be copied to disk. The directory is 
for more than one OPLD entry pointing to a directory 
more than one entry is found (as would be the case 
ing the SYSTEM file after SYSEDIT's had been 
the relative sector address of the first OPLD is 
F E T + 6 , and another read is executed to get the 
ctory. Two is added to the current random address 

CIO), and this value is saved as the length 
ctor address of EOI) of the install file. Next the 

searched for the bootstrap program OSB, and its 
ss also saved. Any error encountered during 
ocessing aborts the job with the following message. 



DEADSTART FILE FORMAT ERROR. 

The preset portion of INSTALL completes by making a service call 
to 1IS (function 2) to initialize the SDF. At this point the 
install file is ready to be copied to the SDF device. 

The disk to disk copy mechanism employed by INSTALL utilizes the 
single buffer approach advanced by COPYB. Two FETs point to the 
same buffer and are used in conjunction with control word I/O. 
The install file is copied to the SDF until an EOF is 
encountered. Routine 1 1 S is called once again (function 3) to 
complete operations on the SDF and insert pointer information in 
the deadstart sector. The job terminates with the following 
message . 

SDF INSTALLATION COMPLETE. 

In the event that errors are detected while copying the install 
file, 1 1 S is called (function 4) to release the SDF disk space, 
clear interlocks, and abort the job. 



ROUTINE 1 I S 

Routine 1 1 S is a PP routine which serves as a function processor 
for the CPU program INSTALL. INSTALL communicates with 1 1 S via 
the SYSTEM SPC macro, passing parameters in the call and in word 
5 of the FETs. Recall is on word ARGR ( R A + 2 ) . There are four 
functions associated with 1IS, plus the special case situation 
in which an install job was initiated at deadstart. 

The format of a 1 I S call is as follows. 
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59 




41 


35 




23 




II 





1 1S 





fc 


P1 


P2 



fc Function code 

p1 Relative address of SDF file FET 

p2 Relative address of install file FET 

If an install job is initiated at CMRDECK time, an input file 
FNT/FST is created, containing the logical equipment number of 
the device to receive the SDF. When the job gets scheduled, at 
completion of deadstart sequencing, ' TIS is called into a PP. 
Because there is no function request in the input register, 1 1 S 
knows that the job was initiated during the deadstart process. 
It then creates an LOFT type FNT entry for the SDF with the 
specified equipment and a special file ID (77B) . 

The special file ID is set so that later on when the file is 
used (function 2) it can be determined that 1 1 S created the FNT/ 
FST with proper equipment number, as opposed to a local file of 
the same name (SDF) associated with an install job initiated on 
line. The file type is changed to LIFT at job completion, 
before the system sector is written. Lastly, 1IS copies two 
control statements to the control statement buffer, sets buffer 
pointers, and exits to PP resident. The control statements are: 

COMMON, SYSTEM. 
INSTALL. 



Function 1 - Validate Install File 

Routine 1 1 S searches the FNT for an assigned file named in the 
FET, and if not found, aborts with the message INSTALL FILE NOT 
FOUND. Likewise, if the install file is not on mass storage, 
the job aborts with the following message. 

INSTALL FILE NOT MASS STORAGE. 

Next, 1 1S locates EOI on the install file, stores the EOI 
address in the FST, stores the FNT address in the FET, and then 
exits (function complete). 
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Function 2 - Initialize SD F 

Routine 1IS searches the FNT for an assigned file named SDF. 
a file is found but not with the special file ID, the job is 
aborted with the following message. 



If 



ASSIGNED FILE CONFLICT - SDF. 

If a file is not found, an equipment number for the SDF device 
is extracted from the FET parameter word and validated, after 
which a FNT/FST is created. Next, 1 1S attempts to set the 
global utility interlock and if successful, advances the active 
user count to prevent the device from being unloaded. If the 
interlock is unavailable, 1 1S goes on recall (RLPW) . A flashing 
message to this effect is sent to the B display. With the global 
interlock secured,. 1IS checks the MST for presence of an 
existing SDF. If one exists, the deadstart sector is read via 
OPI, the SDF indicators cleared, the sector rewritten, the SDF 
track chain dropped, and the SDF flag in ACGL cleared. Routine 
1IS now gets the length of the install file from its FET, and 
using SLM for the SDF device, determines the number of tracks 
required for the SDF. Using the RTCM function, 1IS requests all 
available disk space on the SDF device and counts the tracks in 
the allocated chain via COMPSEI. If the number of tracks 
assigned is insufficient to accommodate the install file, the 
track chain is released, the global interlock .c leared (and user 
count decremented), and the job aborted with the following 
message. 

TRACK LIMIT ON SDF DEVICE. 

If more than the required number of tracks is available, 1IS 
drops into a loop, using COMPSNT and decrementing the assigned 
track count until it matches the required count. When this 
occurs, the first track for the SDF has been identified. Next 
the DLKM function is used to release the unneeded space from the 
beginning of the disk chain. Routine 1IS completes by setting 
first sector and first track equal to the current track in the 
FST. 

Function 3 - Complete SDF Installation 

Routine 1IS reads the SDF FNT/FST entry, changes file type to 
LIFT, and sets preserved file status on the SDF track chain. 
Next, the system sector is written and the FNT/FST entry cleared. 
The random address of OSB is extracted from the install file FET, 
and converted to logical track and sector (on the SDF file) via 
COMPCRA. Then the LDAM monitor function is used to calculate 
the physical address of OSB. Routine 1 1S reads the deadstart 
sector via OPI, and sets parameters in the two-word common 
pointer table area reserved for the operating system. The 
layout of the parameter block is as follows. 
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59 




47 






35 




23 






II 







pc 


pt 


ps 


ai 


ot 


ft 


n1 


n2 



pc Physical cylinder of OSB 

pt Physical track of OSB 

ps Physical sector of OSB 

ai Algorithm index for device 

ot Logical track containing OSB 

ft First logical track of SOF 

ni Next physical address when crossing logical track 
boundaries 

After the deadstart sector is rewritten, 1IS sets the SDF flag 
in the ACGL word of the MST, sets a checkpoint on the SDF device, 
and completes by clearing the global interlock and decrementing 
the user count. 

Function 4 - Process Mass Storage Error 

Routine 1 1S releases the SDF track chain, clears the global 
interlock, decrements the active user count, and aborts the job 
with the following message. 

MS ERROR ON DEADSTART FILE. 
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DISPLAY ROUTINES DSD, DIS 



27 



DSD (dynamic system display) and DIS are display routines that 
require a dedicated PP. DSD is placed in PP1 by STL during 
deadstart and remains there while the operating system is 
running- DIS is called to a pool PP by the operator commands 
X.DIS, N.DIS or by the control statement DIS. when the system 
in DEBUG mode and the user has system origin privileges. 



i s 



When DIS is in a PP, it gets a control point and retains both the 
PP and the control point until it is ended by a DROP, or N.DROP. 
The console operator toggles between DSD and DIS by use of the * 
key. More information on the various commands and displays is 
included in the NOS Operator's Guide. 

DSD and DIS use common decks, COMDSYS, COMDDIS, COMDDSP, and 
COMDTFN. 



DYNAMIC SYSTEM DISPLAY (DSD) 



there 



DSD is loaded in PP1 at deadstart time and remains 
throughout system operation. DSD provides an overall status 
display for all currently running jobs via the display console. 
The keyboard of the display console is monitored by DSD and is 
used for operator communication to the system (refer to figure 
27-1). 

DSD runs at the system control point; however, when an input 
requires operation on a job's control point area (change memory 
location or N.DROP., for example), DSD assumes the attributes of 
being assigned to the control point until the operation is 
comp lete . 

If an operator typein requires some control statement action, it 
calls 1DS to initiate this action. If a typein specifies a 
particular display, DSD loads the appropriate overlay to fill 
the screen buffers. 

As DSD receives input, it processes them one character at a 
time as they are received. Checking is performed on each 
character to validate the entry. DSD checks the first character 
and loads the proper syntax table overlay, if necessary. If, as 
the typein continues, the entry is determined to be unique, the 
remainder of the entry is filled in by the input processor. At 
this point, the entry is considered complete, and the keyboard 
echo line is flashed to indicate the complete entry. 
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Console 
Display Screens 




Orives 

via 
channel 



Receives keyboard input 



NOTE 




Transmits overlays to DSD 
over the display channel. 



Gets disk resident 
overlays via a channel. 



DSD does not have a PP resident 

and therefore, in order to load 

overlays it must call (via RPPM) the PP routine 1DL, which 

will get the overlay from the system device and send it to 

DSD via the display channel. 





Calls 



/ids J 



To perform 

auxilliary 

functions 



Figure 27-1- DSD Overview 
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The 99. command disables or enables syntax overlay processing 
and logging of DSD commands in the system and error log dayfile. 
When disabled, DSD does not load overlays to check syntax. This 
should only be done when the system is in an abnormal state to 
prevent PPs from being requested when they cannot perform the 
necessary tasks. 

Each display is controlled by a separate overlay. If the same 
display is requested on each screen, there would be two copies 
of the same display overlay in memory at one time. Refer to 
section 28 for a description of the display screens. 



Overlays may 
the disk (dis 
disk resident 
physi ca I load 
overlay to DS 
are recommend 
1 DL. In addi 
9A2, 9A3, and 

DSD uses thre 
Syntax and co 
overlays are 
ove r lays must 
s c reens . 



reside either in central memory (CM resident) or on 
k resident - default). For those overlays that are 
, DSD calls the program 1DL to process the actual 
ing of the overlays. Routine 1DL then transmits the 
D via the display channel. The following overlays 
ed to be made CM resident: 9A1, 9A5, 9A6, 9A7, and 
tion, efficiency is increased if overlays 9AY, 9A0, 
9A4 are CM resident. 

e types of overlays; syntax, display, and command, 
mmand overlays have absolute origins. Display 
written as location free routines since two display 
reside in DSD at one time for the two display 



STRUCTURE OF DSD 

DSD is structured as follows: 

Resident command syntax table. 

Main program. 

Master display routine. 

Overlay loader. 

Display control tables. 

Keyboard input processing. 

Special character processing routines. 

Keyboard return processors. 

Resident display routines (6 and D displays) that 
display central memory in 5 groups of 4 digits 
with display code translation. 
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• Resident command processors. 

• Resident command processing subroutines. 
Tables and constants for overlay. 

Preset (overlaid after preset by command processors) 
Command Processor and syntax table overlay area. 
Left display overlay area. 
Right display overlay area. 

The following are the command overlays. 



Overlay 


De 


9AY 


N. SYNTAX tabl 


9AZ 


N. SYNTAX tabl 


9A0 


System syntax 


9A1 


System syntax 


9A2 


System syntax 


9A3 


System syntax 


9A4 


System syntax 


9A5 


Central memor 


9A6 


ECS memory ch 


9A7 


Channel comma 


9A8 


Send dayf i le 


9A9 


Control point 


9BA 


Subsystem req 


9BB 


TELEX message 


9BC 


BATCHIO reque 


9BD 


System reques 


9BE 


System reques 


9BF 


Job call requ 


9BG 


System contro 


9BH 


ENABLE syntax 


9BI 


ENABLE syntax 


9BJ 


DISABLE synta 


9BK 


DISABLE synta 


9BL 


Enab le/disabl 


9BM 


Job control r 


9BN 


Job control r 


9B0 


Job control r 


9BP 


Display chang 


9BQ 


File cont ro I 


9BR 


File control 


9BS 


Resource cont 


9BT 


Assign VSN to 


9BU 


Maintenance c 


9BV 


Equipment ava 


9BW 


Mass storage 


9BX 


Enter time 


9BY 


Enter date 



Desc ri pt ion 



e - 
e - 
tab 
tab 
tab 
tab 
tab 
y ch 
ange 
nds 
mess 
req 
uest 
req 
sts 
ts 
ts 

ests 
I re 
tab 
tab 
x ta 
x ta 
e re 
eque 
eque 
eque 
e re 
requ 
requ 
rol 

uni 
omma 
ilab 
vali 



characters A-C, 
characters 0-* 



le, 

le, 

le, 

le, 

le, 

anges 

s 



EN 
B, 
F, 

P/ 
T, 



C, D, E 

I, K, L, 

R, S 

U, V, W 



E-N 



M, 



ages 
uests 
s 
uests 



quests 

le - A-N 

le - 0-Z 

ble - A-N 

ble - 0-Z 

quests 

sts 

sts 

sts 

quests 

ests 

ests 

commands 

t 

nds 

i li ty commands 

d a t i o n 
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The following are the display overlays. 

Overlay Description 



9AA 


Display A, 


9AB 


Display B, 


9AC 


Di splays F 




of 5 digit 


9AD 


Display E , 


9AE 


Di splay E, 


9AF 


Display E, 


9A6 


Display E, 


9AH 


Display E, 


9AI 


Display H, 


9AJ 


Display I , 


9AK 


Display J , 


9AL 


Display K, 


9AM 


Display M, 


9AN 


Display N, 


9A0 


Display , 


9AP 


Display 0, 


9AQ 


Display 0, 


9AR 


Display P , 


9AS 


Display Q, 




queues 


9AT 


Display R, 


9AU 


Display S, 


9AV 


Display T , 


9AW 


Display Y, 


9AX 


Display Z, 



day f i le messages 

system stat us 

and G, central memory, 4 groups 

s with display code translation 

equipment status display 

mass storage devices 

mass storage devices 

resource mounting previews 

magnet i c t apes 

f i le name table 

BATCHIO status 

control point status , 

central program buffer 

ECS memory display 

f i le di sp lay 

transaction terminal status 

sub-control point status 

task library directory 

PP registers 

input, output and rollout 

remote batch status 
system control information 
time-sharing status 
monitor functions 
directory 
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PROGRAMMING CONSIDERATION 

The DISPLAY macro generates the Linkage constants for display 
overlays. In addition, it generates the three-character name of 
the overlay via the OVLN macro. 

The COMMAND macro generates the linkage constants for command 
processing overlays. Like the DISPLAY macro, it generates the 
three-character overlay name. 

The ENTRY macro defines the name of the entry point within 
either a display or command overlay. 

The ENTER macro specifies the format of the keyboard commands. 
Refer to a listing of DSD for use of special characters in the 
command syntax. 

DSD must refresh the screen between 40 and 50 times a second to 
prevent flicker. Thus, display overlays should be short and 
efficient. If a command cannot be executed immediately, or 
requires special processing, DSD should call 1DS to process the 
command. Figure 27-2 is a flowchart of the main loop of DSD. 

The * key is used to toggle between DSD and DIS sharing. the same 
channel. Figures 27-3 and 27-4 are flowcharts showing how both 
routines get and release the channel. In DSD, when the * key is 
pressed, the hold flag CCEQB) in subroutine CEQ is cleared. 
Subroutine CEQ is entered each time through DSD's main loop. 
When DSD has the display channel, the display equipment CDS) is 
not assigned to any control point. 

For DIS, when the * key is pressed, subroutine HDC is executed. 
When DIS is first loaded, it requests the equipment (DS). This 
causes DSD in subroutine CEQ to release the channel and then DIS 
requests the channel. DSD now Loops waiting for the channel. 
When the * key is entered under DIS, DIS releases the channel 
but not the equipment. DSD senses this, requests the channel 
and sets the hold flag. DIS at this time is looping waiting for 
the channel. When the * key is pressed in DSD mode, the hold 
flag is cleared and DSD releases the channel and DIS gets it 
back . 



ROUTINE 1DS 

Routine 1DS processes those functions for DSD which are not 
possible for DSD to process. It is also called to enter jobs 
for 1AJ in certain cases, although not called directly by 1AJ 
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DKB 



display 

keyboard 

buffer 



i 



DLS 



display 
left 
screen 



inactive 
channel 



*1 



1 



DRS 

display 

right 

screen 



process 
keyboard 



I 



CEQ 



check 
equipment 



CSS 



check 

subsystem 

status 



advance 
cycle 
count 




*1 Ensure channel is free before attempting any action on it 

*2 COMDSYS display system status 

*3 Loop. Screen must be referenced 40-50 times a second 



Figure 27-2. DSD Main Loop 
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Figure 27-3. DSD Release/Request Channel Loop 
60454300 A 27-8 




Figure 27-4. DIS Release/Request Channel Loop 
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The DSD call to 1DS is formatted as follows. 

IR IR + 1 IR+2 IR+3 

IR 



IR+4 



1DS 


sc 


jc 


req 


params 


ordinal 



sc System control point number. 

jc Zero if request for system control point, 

nonzero specifies control point to perform at 

req Request . 

params Parameters for specific requests. 

ordinal FNT address of job if jc is nonzero. 



Table 27-1 is a list of all current requests processed for DSD 
and table 27-2 lists the value of the params and ordinal for 
each request. 
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TABLE 27-1. TABLE OF REQUESTS 




Descript i o n 



Load display buffer 
Send dayfile message 
Go 

On switch 
Off swi tch 

Enter central buffer 
Purge f i les 
Rerun job 

Initiate jobs from table 
Initiate j ob call 
Dayf i le dump 
Account file dump 
Error log dump 
Load input jobs 
Not used 

Initiate control card job 
Issue TELEX message 
Issue TELEX warning message 
Send TELEX user a message 
Enter data to running job 
Rollout job 
[Enter job CPU priority 
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TABLE 27-1. TABLE OF REQUESTS (CONTINUED) 



Request (Octal) 



Desc ri pt i on 



26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 

41 



Enter job queue priority 

Set job time Limit 

Assign equipment to job 

CalL DIS to job 

Initiate specified subsystem 

Initiate all enabled subsystems 

Not used 

Enter MAGNET UDT field 

Toggle PF status 

Call checkpoint to job 

Format and send DSD message to 
error log and/or dayfile 

Set/clear bits in MST word AC6L 
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TABLE 27-2. 1DS REQUEST 



Request (Octal) 



Params (IR + 3) 



Ordinal (IR + 4) 





1 
2 
3 
4 
5 



7 

10 

11 

12 . 

13 

14 

15 

16 

17 
20 
21 
22 
23 
24 

25 



Nonzero backspace 
file 

FWA message 



Switch number 

Switch number 

address of message 
buffer 

File type if PURGEALL 
Rerun priority 



Address of job name 

Equipment number 

Equipment number 

Equipment number 

Equipment number 

Request number not 
used 

Address of job name 

Address of message 

Address of message 

Address of message 

FWA of message 

Rollout time, zero i 
not timed 

Priority 



NT address; if zero, 
advance to next 
sector 



NT address if 1 
requested 



Field length 



ID on FNT 



Field length 



Terminal number 
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TABLE 27-2. 1DS REQUEST (CONTINUED) 



Request (Octal) 



Params (IR + 3) 



Ordinal (IR + 4) 



26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 



Priority 

New time limit 

Equi pment 

Desired control point 



Queue priority 



Address of entry 
Bit to toggle or set 

FWA message 



41 



Bit to c lear/set 



Equipment number 



1-send message to 

error log, 
2-send message to 

system dayf i le, 
3-send message to 

both 

Equipment ordinal 
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PIS DISPLAY PROGRAM 

DIS is a display program that may be brought to an empty control 
point (via X. DIS.) to initiate utility programs or to an 
occupied control point to monitor the progress of a job. The 
main features of DIS are that while it is attached to a control 
point, the automatic advance of control statements is stopped 
unless set by the operator and that DIS does not drop when the 
error flag is set unless it is the operator drop flag. Hence 
the programmer is protected from losing the job if he enters 
invalid control statements, or other errors occur. 

DIS provides an interpreted display of the exchange area for the 
job as well as the status of the job. Keyboard entries are 
provided to allow the user to alter central memory in several 
formats, and to execute control statements as if they had entered 
the "system with an input file. In addition, breakpoint and 026 
can be initiated via DIS, as well as other job related commands. 



DIS, unlike DSD, does not have an interpretive command entry 

capability. If a command is not recognized as a legal DIS 

command, it is assumed to be a control statement and executed as 
such . 

Only displays that are not overlays are permittted on the right 
screen since displays are not relocatable as they are in DSD. 
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rt discussion (with flowcharts) was 
DSD with DIS if both share the same 

The following is a short 
hen the HOLD, command is issued 
equipment and channel are both 
channel, DSD is in a loop waiting 
DIS releases it, DSD gets it. DIS 
r the operator to assign the 
as the operator assigns the 
uest it and get it since it never is 
ense that the equipment has been 
nnel. DIS will now get it back. 
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DIS can be called to a control point in one of three ways. 

• DIS. control statement. If the running job has system 
origin privileges and the system is in DEBUG mode, DIS 
is loaded into a PP and assigned to the requesting job. 

• N.DIS. This operator command brings DIS to a control 
point that is already occupied by a running job. If 
there is no job at the control point, the command is 
considered illegal. This method of calling DIS is known 
as the di rect call. 

• X.DIS. or X. DIS,xxxxxx. Where xxxxxx is requested field 
length. If either of these operator commands is used, 
DIS is brought to an empty control point. If the second 
form is used, the requested field length is assigned 
before giving control to the user. If the first form is 
used, 60K octal is the default field length requested. 

Refer to the NOS Operator's Guide for information on commands and 
displays available under DIS. 

The main loop of DIS is flowcharted in figure 27-5. 
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CJS 



check job status 



SYS 



display 
system status 



/ DDN 




/ display 

\ display names 



DLS 



display 
left screen 



DKB 



display 
keyboard buffer 






KBI 



/ get keyboard input 
\ and execute if 
\ complete 




Figure 27-5. DIS Main Loop 
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STRUCTURE OF DIS 

DIS is structured as follows. Resident routines include: 

Main program and subroutines. 

Keyboard input. 

Keyboard input subroutines. 

Interpret keyboard message. 

Resident display routines: 

D i sp la y Desc ri pt i on 

8 Control point status. 

C Central memory (5 groups of 4 digits with 
display code translation). 



Same as di splay C . 

Blank screen. 

Text display. Displays text from central 
memory in coded lines. Lines are folded at 
60 characters. Display is terminated after 
256 words have been displayed. 

Text display. Same as Display T. 



• Display subroutines 

• Display common decks: COMDDIS, COMDDSP, COMDSYS 

• Resident command processor routines: 
Rout i ne Desc r ipt i on 

Call DIS and drop display 

Drop di sp lay 

Set error flag PPET 

Drop display and wait for reassignment 



DIS. 
DROP. 
ERR. 
HOLD. 

• Command processor subroutines. 

• Table of displays. 

• Preset program (overlaid). 
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*«* ^«nlavs incLude the foLLowing: 
Overlay areas for displays m^uu 

Ov erlay Display Description 

Dayf i le 

Magnetic tapes <E,T display for DSD) 
Central memory (4 groups of 5). 
Central memory (4 groups of 5). 
Fi le name table (job) . 
System status . 
Equipment status table. 
File name table (system). 
ECS memory display. 
PP regi sters . 

Input/output and rollout queues. 
Central memory buffer. 
Monitor functions. 
Di rectory. 



9EA 


A 


9EB 


E 


9 EC 


F 


9ED 


G 


9EE 


H 


9EF 


J 


9 EG 


K 


9EH 


L 


9EI 


M 


9EJ 


P 


9EK 


Q 


9EL 


V 


9EM 


Y 


9EN 


Z 
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Overlay areas for commands include the following: 



Over lay 


9E0 


9EP 


9EQ 


9ER 


9ES 


9ET 


9EU 


9EV 


9EW 


9EX 


9EY 


9EZ 


9E0 


9E1 


9E2 


9E3 


9E4 


9FA 


9FB 



Desc ri pt i on 

CPU commands 

Statement entry 

Execute statements 

Enter regi sters 

Enter X register 

Enter memory 

Ent e r i nst ruct i on 

Enter ECS 

Enter memory/enter instruction exit 

CPU program interface commands 

Ent e r field lengt h 

Enter ECS field length 

Call 026 to control point 

Miscellaneous commands 

Miscellaneous commands 

Interpret keyset message 

Check keyboard request 

Interpret more messages 

Call PP program 



OVERLAY RESIDENCY AND 1DL 

Unless DIS is used heavily, it is not necessary to make any of 
the overlays central memory resident. 

In order to load any disk resident overlay, DIS employs the 
assistance of 1DL (same routine that DSD uses) to do the actual 
load from disk. After 1DL has the overlay in its memory, then 
it is transferred to DIS's memory via the display channel. 
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CENTRAL PROGRAMMABLE K DISPLAY 



28 



CONSOLE COMMUNICATION 

The CPU programmer can display information on the K display and 
receive operator keyboard input with the CONSOLE macro. This 
macro causes the display of a specially formatted, central 
memory buffer. The format of the CONSOLE macro is as follows: 



LOCATION 



OPERATION 



CONSOLE 



VARIABLE SUBFIELOS 



addr 



addr 



Address of parameter word 



The parameter word, addr, must be defined by the user as follows 



addr 



59 


35 


17 


kbuf 


rscr 


Iscr 



kbuf 



rscr 



Iscr 



Address of 8-word area where operator 
keyboard input will be written in the 
user's program 

Address of specially formatted, 
right-screen buffer 

Address of specially formatted, 
left-screen buffer 



The left- and right-screen data buffers must be preceded by 
control words that are formatted as follows: 



rscr 

or 

Iscr 



59 






47 





s 


f 


c 
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Character size. If zero, indicates small 
characters (64 characters/ li ne) . 
Characters are eight units apart and lines 
are 10 units apart (refer to Display in 
this section). If s equals one, indicates 
medium characters (32 characters/ I i ne) . 
Characters are 16 units apart and lines 
are 20 uni t s apart . 



Form 
form 
data 
i n b 
h ave 
al I 
1, c 
The 
( lin 
cont 
zero 
word 
been 
to b 
d i sp 
I i ne 



at. If 

at. Af 

is out 

yt e o 

been o 

c o o r d i n 

oded fo 

buf f e r 

e i s te 

ains a 

is e n c 

of a I 

di spla 

e speci 

I a y e d s 

7 (37 



f = 
ter 
put 
f a 
utpu 
ates 
rmat 
is a 
rmi n 
zero 
ount 
ine, 
yed. 
f ied 
tart 
I i ne 



0, 
the 
unt i 
word 
t . 

( re 

(C 
ssum 
ated 
) an 
ered 

or 
Co 
. T 
i ng 
s) . 



spec 
di sp 
I a 

or 
The 
f er 
f o rm 
ed t 

whe 
d i s 

i n 
unt i 
ordi 
he d 
wi th 



i f i e 

lay 

zero 

unt i 

data 

to D 

at) 

be 
n by 

out 
byte 

1 51 
nat e 
ata 

lin 



d prog 

is se I 

i s en 

1 512 
must 

i splay 
i s spe 

in C 
te 4 o 
put un 

of 

2 wo rd 
s do n 
wi 11 b 
e 43 t 



ram 

ect ed, 
countered 
words 
contai n 
) . If f = 
c i f i e d . 
format 
f a word 
til a 
the first 
s have 
ot have 
e 
hrough 



If this is preset to zero, it may 
subsequently be checked for nonzero which 
indicates data has been displayed at least 
once. In this way, the user can tell when 
the K display was actually assigned to his 
cont rol po i nt . 



The CONSOLE macro causes the system to put out the message on 
B display requesting the K display for this job. 



the 



DISPLAY SCREEN 

The display screen is divided into a grid that consists of 51 
lines and 64 columns (based on small characters). The spacing 
between columns is eight coordinate positions or units, and 
between lines is 10 coordinate positions or units. The areas of 
the display screen (left or right) are limited to those lines 
above line 4 and below line 46. If the user displayed 
information outside of these limits, the display headers could 
be destroyed as well as other system information that is 
normally displayed on the bottom of each screen. 
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The disolay arid can be laid out using X and Y coordinates, 
Ihtrt (SoOOB? 7000B) is the lower-left point of reference, as 



f o L Lows . 



(6000B,7777B) 



(6000B,70Q0B) 



(6777B,7777B) 



|(6777B,7000B) 



in terms of lines and columns, the display screen i s f ^"J*^ 
as follows. There are 51 lines each consisting of 64 characters 
(smal I si ze) . 



(0,50) 



(0,0) 




(63,50) 



(63,0) 



The user should only use lines above line 4 and below n 46. 

This means the first line that should be used at the top s 

line 45 and the last line t- be used at the bottom is line 5, as 
f o I lows . 
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(0,45) 



(0,5) 




(63,45) 



(63,5) 



The area 
f o I Lows . 



that is used if the coded format is selected is as 



(0,43) 



(0,7) 




(63,43) 



(63,7) 
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. . j- „+.«* mnet hp sDecified for program format and 
The Arth Y e f??sr?wo by?es of each line; othe'rwile the data is 
must be the f i ^ *"? ° y *!* Last va iue of the X and Y 
displayed starting M Jj*^. 1 "*^; of calculating the exact X 
coordinates. To si mp li f y the P^« ss . ° the DSL macr0 can be 
and Y coordinates for a parti u e ' ™ DSL 

used (available on common deck COMCMAC). me 
macro is as follows. 



LOCATION 



OPERATION 

DSL 



VARIABLE SUBFIELDS 



x,y, string 



st ri ng 



Column or X-coordinate (character position 
through 63 for small characters) 

Line or Y-coordinate (line number 
through 50 for small characters) 

Character string to be displayed, .(assumes 
64 characters per line) 



NOTE 

Medium characters are twice 
the size of small characters. 

Refer to the sample program at the end of this section for the 
use of the CONSOLE and DSL macros. 



DISPLAY PROGRAMMING 



in order to have some parts of the display at a higher ^tensity, 

he user can output the same line two or three time s For 
example, if line 45 is to be intensified, use the following. 



DSL 
DSL 
DSL 



0,45, data 
0,45, data 
0,45, data 
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When dispLaying using the program format, it is not necessary to 
dispLay the Lines in numerical order; that is, Line 45 foLLowed 
by 44, then 43, etc. The user can dispLay any Line or any part 
of a Line in any order, since each Line must begin with an X,Y 
coordinate and, if desired, a part of a Line can begin with an 
X,Y coordinate. The X,Y coordinates can appear anywhere in the 
user's data buffer -- the 6xxx means an X coordinate, the 7yyy 
means a Y coordinate. 

In addition to the sampLe program in this section, the user can 
find exampLes in routines MODVAL, PFS, and QFSP. 

KEYBOARD INPUT 

When receiving information from the keyboard, the buffer (KBUF 
in this case) is fiLLed with characters when the carriage return 
CCR) key is pressed. Characters are transmitted to KBUF from 
the keyboard buffer in DSD Lef t- j us t i f i ed, 10 characters per 
word. The Last word is not fiLLed beyond the finaL keyboard 
entry. Therefore, if the user zeros KBUF prior to receiving 
data, the first 6 bits of zero will signaL the end-of- 
information. 
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If the user's CPU program needs to wait for keyboard input, a 
RECALL should be issued as in figure za-i . 



— ►fi 


v Y es 






keyboard ^* 
buffer^ 


issue 




RCL request 




Figure 28-1. Sample Keyboard Main Loop 
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K-DISPLAY STANDARDS 

If the programmer creates a K-display processor for the operating 
system or changes an existing processor, the guidelines 
described in the following paragraphs should be followed. 

A K-display processor is defined as a program that interacts 
with the operator by means of a K display. The function 
associated with a particular processor is defined as a process. 
For example, MSI is a process and its process is initializing 
devices; PROFILE is a processor and its process is updating 
charge numbers in the profile file. 

Two types of processes exist, dynamic and static. A dynamic 
process processes each directive as it is entered at the 
keyboard. The operator must indicate to the processor when to 
complete the process by typing a special command. Updating a 
charge number with PROFILE is an example of a dynamic process. 
A static process is where a complete set of directives must be 
entered before the process may be initiated. The operator must 
indicate to the processor when to initiate the process by typing 
in a special command. Initializing a device with MSI is an 
example of a static process. 



K-DISPLAY ENTRIES 

Directives and commands are the two types of K-display entries 
a processor is concerned with. Directives set the values of the 
parameters needed by the processor to complete a process. 
Directives generally take the form of dd=xxxx. Keywords should 
consist of two letters. An equal sign separates the keyword 
from the associated values. Standard keywords include the 
f o I lowi ng . 

Keyword Description 

UN User number 

U I User i ndex 



DA 
FM 
DT 
DN 
EQ 
DM 
DE 
DD 



Date 

Fami ly name 

Device type 

Device number 

Equipment number 

Devi ce mask 

Dens i ty 

Destination device number 



More than one directive should be allowed on the same line. 
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Commands are instructions to the processor. This type of 
K-display entry tells the processor to initiate, terminate, or 
proceed with the current process. They do not affect the value 
of parameters needed by the processor to complete the process. 
Commands usually consist of a single keyword. 

The following commands should be available for dynamic 
processors. 



Command 



END 



DROP 



STOP 



Desc ri pt i on 

Terminate input of directives; complete 
the particular process. A new process 
begins with the entry of the next 
di recti ve. 

Terminate input of directive for current 
process. Do not complete the process, but 
rather ignore it. A new process begins 
with the entry of the next directive. 

Terminate the program; do not complete 
process if one is in progress. 



The following commands should be available for static processors 



Command 



GO 



RERUN 
RESET 



Pes c ri pt i on 

Proceed with the process using the 
directives that have been entered. The 
processor informs the operator of the 
completion of the process by asking for a 
new set of directives for the next process, 
or, if there is no next process, to end the 
run. 

Reinitialize the processor. 

All directives are reset to the default 
va lues . 

Page K display forward one page. 



K-DISPLAY FORMAT 

The left screen is the primary screen for the K-display 
processor. The right screen should be used for related 
information an operator would need for efficient use of the 
processor. This information should go on the right screen only 
if there is not enough room on the left screen. 
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The primary screen can be divided into three general areas, as 
f oL Lows . 




Area I contains the directives that are accepted by the 
processor and the value currently assigned to that directive. 
As each directive is entered by way of the keyboard, the 
displayed value is updated to reflect any change. 

Area II contains a description of each of the directives found 
in area I. This description should include what values the 
directive may assume. The directive and its value in area I 
should be on the same line as its description in area II. 

Area III consists of at least two lines. The bottom line should 
be used to display the directives that have just been entered. 
The top line should be used to inform the operator of the 
status of the processor. The status would include any error 
messages, informative messages, or requests from the processor. 



SAMPLE PROGRAM 

The sample program executes the CONSOLE macro and the system 
requests the K display to be brought to the left screen (refer 
to f i gure 28-2) . 

The operator would type K,2. The first part of this program 
uses medium characters. The K display is brought to the left 
screen and the user's job displays the information as shown in 
figure 28-3. The left screen display asks the operator to bring 
the K display to the right screen also; he types in KK. Figure 
28-4 shows what the two screens look like at this point. 
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This is a 
flashing 
mes sage 



Figure 28-2. B Di splay 
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Figure 28-3. K Display, Left Screen 
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ALTERNATES 
BETWEEN LEFT 
AND RIGHT 
SCREENS 



Figure 28-4. K Display, Left and Right Screens 
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In the middle of each screen is a flashing message (HI on the 
left screen and THERE on the right screen). Below the flashing 




of the screens is changed. The next part of the program uses 
small characters and demonstrates the use of flashing parts of 
lines instead of entire lines. Figure 28-5 illustrates this 
display. 



To terminate the program, the user types in any message 
terminated with a CR. The following messges are put in the 
user's day file before ending. 



INFORMATION RECEIVED 
END OF TEST 
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NOTE 

Words SMALL and NOTE flash on the Left 
screen, along with input request. 



Figure 28-5. Small Characters, Left and Right Screens 
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IDENT KDS 
ENTRY KDS 
SYSCOM B1 



***** THIS PROGRAM USES THE DSL AND CONSOLE MACROS FROM 

* COMMON DECK COMCMAC TO DISPLAY MESSAGES ON THE 

* LEFT AND RIGHT SCREENS VIA THE K DISPLAY. 



KDS 



KDS1 



KDS2 



KDS3 



THIS FIRST SET OF DISPLAYS USES MEDIUM CHARACTERS. 

SYSTEM WILL REQUEST *K* DISPLAY 

IF LEFT SCREEN DISPLAYED 

LOOP UNTIL LEFT SCREEN IS DISPLAYED 

DISPLAY MESSAGE TO OPERATOR 

CHECK RIGHT SCREEN 
IF NOT DISPLAYED YET 



SB1 


1 


CONSOLE DSW1 


SA1 


MLS 


LX1 


59-0 


NG 


X1,KDS2 


RECALL 




EQ 


KDS1 


SA1 


BLK 


BX6 


X1 


SA6 


MLS1 


RECALL 




SA1 


MRS 


LX1 


59-0 


PL 


X1,KDS3 



* THE FOLLOWING CODE PUTS OUT A FLASHING MESSAGE ASKING FOR 

* AN OPERATOR TYPE-IN. THE MESSAGE IS ALTERNATED BETWEEN THE 

* LEFT AND RIGHT SCREENS. 

MX6 

SA6 MLS1 

SB7 BO 

SB5 LTYP 

KDS4 SA1 TYP+B7 MOVE OPERATOR MESSAGE TO DISPLAY AREA 

BX6 X1 

SA6 MLS2+B7 

SA6 MRS2+B7 

SB7 B7+B1 

NE B5,B7,KDS4 IF NOT FINISHED 

SA1 BLK 

BX6 X1 

SA6 MLS1 

KDS5 RECALL 

SA1 KBUF 

NZ X1,KDS7 IF SOME KEYBOARD INPUT 

SA1 BLK 

SA2 FLS 

SA3 MLS1 

SX6 X2-1 DECREMENT FLASH COUNTER 

SA6 FLS 
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NZ . X6,KDS5 IF NOT TIME TO CHANGE FLASH STATUS 

SX7 FLC RESET FLASH COUNTER 

SA7 FLS 

ZR X3,KDS6 IF LEFT DISPLAY OFF 

MX6 LEFT DISPLAY ON 

SA6 MLS1 SO TURN IT OFF 

BX6 X 1 

SA6 MRS1 TURN ON RIGHT SCREEN FLASH 

EQ KDS5 

KDS6 MX6 TURN OFF RIGHT SCREEN FLASH 

SA6 MRS1 

BX6 X1 

SA6 MLS1 TURN ON LEFT SCREEN FLASH 

EQ KDS5 LOOP WAITING FOR KEYBOARD INPUT 

* * THE FOLLOWING CODE WILL DISPLAY SMALL CHARACTERS AND 

* WILL DEMONSTRATE THE CAPABILITY OF FLASHING PARTS OF 

* LINES INSTEAD OF ENTIRE LINES. 



KDS7 



KDS8 



KDS9 



MESSAGE KDSA, ,R 


MX6 





SA6 


KBUF 


SX6 


FLC 


SA6 


FLS 


CONSOLE DSW2 


SA1 


SLS 


LX1 


59-0 


NG 


X1 ,KDS9 


RECALL 




EQ 


KDS8 


RECALL 




SA1 


KBUF 


NZ 


X1 ,KDS1 1 


SA1 


BLK 


SA2 


FLS 


SA3 


SLS1 


SX6 


X2-1 


SA6 


FLS 


NZ 


X6,KDS9 


SX7 


FLC 


SA7 


FLS 


ZR 


X3,KDS10 


MX6 





SA6 


SLS1 


EQ 


KDS9 


BX6 


X1 


SA6 


SLS1 


EQ 


KDS9 



CLEAR KEYBOARD BUFFER 
RESET FLASH COUNTER 

IF LEFT SCREEN DISPLAYED 
LOOP 

IF SOME KEYBOARD INPUT 

DECREMENT FLASH COUNTER 

IF NOT TIME TO CHANGE FLASH STATUS 



IF FLASH PARTS OFF 

FLASH PARTS ARE ON - TURN OFF 



KDS10 BX6 X1 FLASH PARTS ARE OFF - TURN ON 



KDS1 1 MESSAGE KDSA, ,R 

MESSAGE (=C* END OF TEST.*),,R 
ENDRUN 
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KDSA 



DATA C* INFORMATION RECEIVED.* 



BLK 


DATA 


FLC 


EQU 


FLS 


CON 


DSW1 


VFD 



10H 

100 FLASH COUNTER VALUE 

FLC FLASH COUNTER 

24/KBUF,13/MRS,l8/MLS 



DSW2 



VFD 



24/KBUF,l8/SRS, 18/SLS 



KBUF 


BSSZ 


8 


MLS 


VFD 


10/0, 1/1 ,1/0,47/0, 1/0 




DSL 


0,44, (TOP LINE FOR MEDIUM CHARACTERS.) 




DSL 


0,5, (BOTTOM LINE FOR MEDIUM CHARS.) 




DSL 


8,39, (LEFT SCREEN.) 




DSL 


8, 39, (LEFT SCREEN.) 




DSL 


0,37, (TEST OF *CONSOLE* MACRO.) 


MLS1 


DATA 







DSL 


16, 33, (HI) 




DSL 


16, 33, (HI) 


MLS2 


DSL 


0,29, (PLEASE BRING K DISPLAY TO) 




DSL 


0,27, (RIGHT SCREEN ALSO.) 




DATA 





TYP 


DSL 


0,27, (PLEASE TYPE SOMETHING IN.) 




DSL 


0,27, (PLEASE TYPE SOMETHING IN.) 




DSL 


0,27, (PLEASE TYPE SOMETHING IN.) 




DATA 





LTYP 


EQU 


*-TYP 


MRS 


VFD 


10/0, 1/1 , 1/0,47/0, 1/0 




DSL 


8, 39, (RIGHT SCREEN.) 




DSL 


8,39, (RIGHT SCREEN.) 




DSL 


0,37, (TEST OF *CONSOLE* MACRO.) 


MRS1 


DATA 







DSL 


16", 33, (THERE. ..) 




DSL 


16, 33, (THERE. ..) 


MRS2. 


BSSZ 


LTYP 


SLS 


VFD 


10/0,1/0,1/0,47/0, 1/0 




DSL 


0,45, (TOP LINE FOR SMALL CHARACTERS.) 




DSL 


0,5, (BOTTOM LINE FOR SMALL CHARACTERS.) 




DSL 


3,30,( THIS IS WHAT) 




DSL 


25,30,( CHARACTERS LOOK LIKE.) 




DSL 


6,28, (THE FLASHING MESSAGES ARE ONLY PARTS 


SLS1 


DATA 


10H * 




DSL 


19,30, ( SMALL) 




DSL 


19,30, ( SMALL) 




DSL 


0,28, (NOTE- ) 




DSL 


0,28, (NOTE- ) 




DSL 


0,16, (PLEASE TYPE IN SOMETHING TO TERMINATE 




DATA 





SRS 


VFD 


10/0, 1/0, 1/0,47/0, 1/0 




DSL 


3,30,( THIS IS WHAT SMALL CHARACTERS LOO 




DATA 







END 


KDS 
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LOCATION-FREE ROUTINES 



29 



a p P routine may need some special operations 
During execut i on, a PP rout i » m y f epent areas of PP 
performed. Depend ng on the rout in ^ ^ routines . 
memory may be avaiiaoie 

ln order to Load a PP routine anywhere in PP memory, the concept 
of Location-free routines is used. 

Two macro packages, COMPREL and COmPRLI, provide the capability 
for a routine to be seLf-reLocat i ng . 

By convention, any PP routine whose ^^^^^TJ * 
considered a Locat ion-f ree_rout i ne . ^ A ^^J,, direct ceL 

reside, sets the A 




COMMON DECK COMPREL 

If the user inserts =o«on deck COMPREL in his program all 

instructions automat, ca LLy have ^inserted^ ^ ^^ 




LJM. tag 
Any K-type instruction whi ch re f.r.ne., . cell Refined i n 
NOSTEXT CPPCOM) is not re locate d if «LS is deTi q 
otherwise, the Instruction «il be relocated. [' cod 

wishes to code nonre locatable code •«" J 1 * n r COMPREL . COMPREL 
he uses the macro RSTR, which is contained in cumr 
^locates instructions with reference to LA a J« t<) 
encountered in the code. Thi then <^ e * a rf r ; ct - addr essing 
occur at execution time through the indexed Direct 

scheme. 
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COMMON DECK COMPRLI 



The second method of coding a Location-free routine is to use 
COMPRLI, which relocates indirectly. All the rules of COMPREL 
apply, with the exception that it is legal to relocate I/O 
instructions. In addition, the three C-type instructions, LDC, 
ADC, and LMC, are also relocatable. 

Where COMPREL relocates instructions as it encounters them, 
COMPRLI builds a remote table using the RMT pseudo-op (refer to 
the COMPASS Reference Manual) containing the address of the 
instructions that need to be relocated. The first executable 
statement must be: 

RJM. REL,LA 

The routine REL is in COMPRLI. REL searches through the remote 
table and relocates all instructions whose addresses are stored 
in the table. The user must call COMPRLI. 

Listings of COMPREL and COMPRLI are obtained by assembling 
CALLPPU. 

The following is a list of location-free routines available in 
NOS. 



Desc ri pt ion 
Update project profile file 
Verify user name 
Begi n file 
Banner page 
Drop file 

Release fast-attach files 
Initialize MMF link device 
Update resource files 
Release permanent file 
Process system device errors 
Verify job/user statements 
Firmware ident processor (6DI driver) 
Track flaw processor (6DI driver) 
Pack serial processor (6DI driver) 



Routine 


OAU 


OAV 


OBF 


OBP 


ODF 


OFA 


OMF 


ORF 


ORP 


OSE 


OVJ 


OCI 


OTI 


OPI 
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LOADING ZERO-LEVEL OVERLAYS 



In NOS, location-free routines are called zero-level overlays. 
Since location-free routines can reside anywhere within PP 
memory, it is quite important that the caller of a location-free 
routine guarantee that the loading of such a routine does not 
destroy meaningful data or instructions. Common deck COMSZOL 
defines symbols for the length of the zero-level overlays. 
These values represent the number of words needed by the routine 
to perform its task. This value is less than or equal to the 
amount of PP memory used to load the overlay. The amount of 
memory destroyed is rounded to the next highest number of 
sectors if the routine is loaded from RMS (that is, if the 
routine requires 501B bytes, 1200B bytes are destroyed by the 
load from RMS). The user should employ the OVERFLOW macro, found 
in COMPMAC and COMSZOL, to guarantee that the memory destroyed 
by the loading of a zero-level overlay is not meaningful. 
Listings of COMPMAC and COMSZOL can be obtained by assembling 
CALLPPU and CALLSYS. 
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PRODUCT SET INTERFACE 



30 




tive, the predecessor versions of NOS 




ped 



SCOPE FUNCTION PROCESSOR 
SFP is a function process* 



or that is called when the PP program 
i:Wel^^not\eV :n6 in the peripheral library directory 
(PLD) . 



TheRA+1 calls processed by SFP consist of the following. 



Call 

STS 

MSD 

PFE 

ACE 

PRM 

CKP 

REQ 

DMD 

DMP 

D00 

FIN 

DEP 

DED 



Desc ri pt ion 
Status processor 
SDA/SIS message generator 
Alter function 
Advance control statement 
Pe rmi ssi on check 
Checkpoint request 
NOS/BE equipment request 
Dump CM field length in display code 
Dump CM field length 
Error text processor 
Translate FIN (NOS/BE) requests 
Dump ECS field length 
Dump ECS field length in display code 
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SFP STRUCTURE 

SFP consists of a main program and overlays that are Loaded 
depending upon the function being processed. 



The main program in SFP determines which overlay needs to be 
loaded by processing the RA+1 call. 



STS REQUEST 

The STS request is processed by overlay 2SA. The RA+1 format for 
the STS call is as follows. 



RA + 1 



59 




41 


35 




23 


17 







STS 





func 





addr 



func Function code 

addr Status return address 

Function 01 

This function returns the status of mass storage devices starting 
at location addr+1 . The data returned consists of the following. 



addr 



59 




47 




35 




23 










11 


/r 





c 



11 Number of words, excluding addr+0, to be 
used for return information; this value 
must be set nonzero by the caller 

Ir Number of status words returned 

c Set to 1 when operation is complete; caller 
must set to zero 
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The mass storage device status is 
the following format. 

59 47 35 



addr+n 



status 

st atus 

000 
040 
120 
140 
620 
640 
700 
740 



devt 



status 



devt 




i n 



Status of mass storage device as follows. 



Desc ri pt i on 

Not available, off, not in use 

Unloaded pack 

N0S system routines 

N0S system routines on pack 

Contains permanent files 

Pack with permanent files 

N0S system and permanent files 

N0S system and permanent files 

pack 



on 



N0S/BE hardware mnemonic in display code (for mass 
storage devi ces) . 



Mnemom c 


i/e:»i>i i^viw.. 


AA 


6603 Disk System 


AB 


6638 Disk System 


AD 


865 Drum System 


AF 


814 Disk System 


AL 


821 Disk System 


AM 


841 Disk System 


AP 


854 Disk System 


AY 


844-2X Disk System 


AZ 


844-4X Disk System 


DE 


ECS System 


DP 


DDP System 



est ord 



chan 



eq 



PRU 



EST ordinal of the mass storage equipment. 
Primary 1/0 channel for the equipment. 
Equipment number. 

Number of PRUs/100B of space remaining on the 
device. A value of 7777B indicates at least 



262,100 PRUs available. 
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Function 02 

Returns to the calling program the FNT/EST entries of files 
requested whose names are set in every third location starting 
with addr+1 - If the file exists, the file name is replaced by 
the FNT/FST of NOS mapped into the NOS/BE FNT/FST. If the file 
does not exist, the file name is zero. 

The data returned consists of the header word in addr+0 in the 
same format as for function 01. The mapped FNT/FST for the named 
file is returned 3 words per entry as follows. 



59 



53 



47 



35 



23 



17 



11 







file name 





cp 





devt 





1st track 


cur. track 





cur. sector 





disp. code 


P 
e 
m 





cs 



file name 

cp 

devt 

1st track 

cur . track 

cur. sector 

disp. code 



pern 



cs 



Name of the file 

Control point assignment 

NOS/BE device type 

Fi rst track 

Current track 

Current sector 

Di sposi t i on code 

40 Print 

10 Punch 
Permanent file permissions 

1111 No cont ro Is 

0000 Execute only 

0001 Read 
1101 Extend 
1011 Modify 

Code and status (same as byte 4 of the NOS 
FST entry) 



The device type (devt) file, may contain those mass storage 
values listed for function 01 as well as the following items. 



Device Type 



CR 
CP 
LP 
LQ 
LR 
TA 



Desc r ipt i on 



Card reader 

Card punch 

Li ne pri nter 

Line printer 

Line printer 



(512) 
(580) 



Time-sharing terminal 
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netic tapes, the device types are as follows 

Description 



For mag 

Device Type 



MT 
NT 

40nn 
41 nn 

nn 

xxxxl 
xxOOxx 
xx01 xx 
1 Oxxxx 
1 Oxxxx 
1 1 xxxx 



Seven-track 1/ F formats 
Nine-track I, F formats 
Seven-track SI, S, L formats 
Nine-track SI, S, L formats 



Meani ng 

Density (always 
Unlabeled 
Standard labels 
SI format 
S format 
L format 



800) 



Funct ion 




23 



second word is zero. 



4^ + e. «-f thp header word as described for 
The data returned consists of the nea aer wo u 
function 01 and data words of the following format. 



addr + 1 



+ 2 
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MSD REQUEST 

The MSD request is processed by overlay 2SB. The RA+1 call for 
MSD has the following format. 



RA + 1 



59 




41 




29 


17 





MSD 





message code 


addr 



message code Ordinal of message to be returned 
addr Address to receive message 

The format of addr is as follows. 



59 



addr 



47 



35 



23 



mess 
code 


mess 
size-1 


mess 
size 





c 



mess code Message code 

mess size Length of message in CM words 
c Completion bit; set to 1 when 

function is completed 

The message text is returned beginning at location addr + 1 . 
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PFE REQUEST 



j u ,*., A ».ia\/ PSD. The PFE request 
he PFE request is P™ cessedby a n EO recorded at the current 
Iters the requested file with an EOI recorae 



Th 

position of the mass storage file.. 

The format of the RA + 1 PFE call is as follows 



59 



RA+1 



41 



35 



PFE 



17 



addr 



addr 



.ddr'ess of a parameter word 



The parameter word has the following format. 



59 



addr 



file name 



17 



ret 



8 5 10 



fc 



file name 
ret 



opt 
f c 



Name of the f i le ^ 

If bit 6 is set in opt, a return code 

available to the caller. The return codes are, 

000 Function successful 

003 Unknown f i le 

25 File unavailable 

Options (bit 6 is return code to user in ret) 
Function code for alter, bits 
5-2=0111 Completion bit (set to 1 when 
function is completed) 
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ACE REQUEST 



The AC 
reads/ 
t hroug 
the da 
parame 
t hroug 
at the 
set in 
c leare 
the be 
change 
comp Le 
user. 



E request is 

backspaces t 

h RA+77B wit 

yf i Le and/or 

ters in prod 

h RA+53B. If 

end of the 

the functio 

d. If a bac 

ginning of t 

d and an EOR 

te, the comp 

The format 



RA+1 



processed in overlay 2SE. ACE 
he next/previous control statement into RA+70B 
h the option to place the control statement in 

to crack and store the control statement 
uct set or operating system format into RA+2 

a read function is issued and the pointer is 
control statement record, an EOR status (bit 4 
n code is set and RA+70B through RA+77B are 
kspace function is issued and the pointer is at 
he control statement record, the pointer is not 

status is returned. When the function is 
letion bit (bit 0) is set and returned to the 
of the ACE call is as follows. 



59 




41 




26 23 


17 







ACE 





f 





func 



Format : 

x01 
x10 
1 xx 



Crack parameter in operating system format 
Crack parameter in product set format 
Issue control statement to dayf i le 



func CM word containing function (bits 11 through 0) to 
be performed. 



The following functions are valid. 
Funct ion Descri pt ion 



0010 



0040 



Read next control statement and 
advance control statement pointer 

Backspace to previous control 
statement 



ACE calls PP routine TCS after mapping the calling parameters for 
ACE into those recognizable by TCS. 



PRM REQUEST 

The PRM request is processed by overlay 2SF. PRM scans for an FNT 
entry whose name is contained in the call and, if found, maps the 
N0S file permission bits into the N0S/BE permission bits and 
returns them to the caller as a status. If the call address is 
out of range or the requested file does not exist, no diagnostic 
is issued and no status is returned to the caller. 
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The format of the PRM RA + 1 call is as follows 



RA+1 



PRM 



17 



parm addr 



parm addr CM address which co 
search for 



ntains the f i le name to 



The format of parm addr is as follows. 
59 
parm addr 



13 8 



59 

r 



Ifn 



code 



Ifn 
code 



logical f i le name 



A 5-bit code returned by PRM in 

The rightmost four bits are the perm 

octal values for these bits are: 



bits 13 through 9. 

i ssi on bits. The 



01 


Read 


02 


Extend 


04 


Modify 


10 


Control 



f i le 



Bit 13 is zero if the file found is a permanent 
51 equal ton the file, though found, is not a 
pe rmanent file. 

-r. ma n*nt file whose write lockout and/or execute bit(s) 
° r e a se?n the FT read only permission status will be return 
?o the caller! This is due to differences in permanent file 
structures between NOS and NOS/BE. 



ed 
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SPECIAL REQUEST PROCESSING 

The CKP, REQ, DMP, DMD, DEP, and DED requests are processed in 
overlay 2SG, special request processing (SRP). 

SRP consists of routines which set up a special processing word 
in the calling control point area (SPCW) for follow-up processing 
by 1AJ and a CPU program associated with the call. The format of 
SPCW is as follows. 



SPCW 



59 




41 


35 




17 







entry point 


codes 


param 


paddr 



entry point Name of entry point in CPU program 

codes Control codes for use by 1AJ 

Bit Description 

41 Request active (1AJ use only) 

40 Clear RA+1 before reload if not set 

39 Remainder of word is parameter list (not 

address of parameter list) 
38 Do not restart CPU (1AJ use only) 

param Input parameter (bits 35-18) or status on output (bits 
35-24) 

paddr Parameter address passed in call 
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The SPCW word, with the excep 
format as the RA+1 call. 



tion of the codes field, is th 



e same 



tion 25, The REQ RA+1 
FM 



The CKP RA+1 request is discussed in section 25 The RE 
request is for compatibility purposes on ly . Equ P^" 1 
assignments under NOS should be made using the proper L 
f unct i ons . 
The DMD and DMP RA+1 requests have the following formats. 



59 



RA + 1 



DMD 



41 35 




f WQ 



17 



Iwa 



59 



RA + 1 



DMP 



35 




fwa 



17 



Iwa 



fwa First word address of CM dump 

Iwa Last word address plus 1 to be dumped 

The DED and DEP RA+1 requests have the following formats 



59 



RA + 1 



41 



DED 




17 




addr 



59 



RA+1 



41 



DEP 




17 




addr 



ddr Address of parameter word 
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Location addr is formatted as follows. 



addr 



59 



47 



23 






fwa 


Iwa 



fwa First word address of ECS dump 

Iwa Last word address plus 1 to be dumped 



ERROR PROCESSOR 

Error conditions detected by SFP and its overlays are processed 
in overlay 2SH, error processor (ERP). 

Routine 2SH is called with an error code in direct cell EI which 
indicates one of the following error conditions. 



Error Code 

SCE 
PCE 
IFR 
IOC 
PAE 

IAF 
SRE 

NET 
NMS 

BET 
IMN 
IOS 



Desc ri pt i on 

SFP call error 
xxx not in PPLIB 
1 1 legal f unct i on 
1 1 lega I origin code 
Parameter error 

Illegal function code 

Special request processing 

error 

Error text not found 

Error text not on mass 

Storage 

Bad error text 

Invalid message number 

I/O sequence error 



Is suing 
Rout i ne 

SFP 
SFP 
2SA,2SE 

SFP,2SA, 

2SC,2SI 

2SD 

2SG 
2SI 

2SI 
2SI 
2SI 
2SD 



When issued to the dayfile the name of the monitor call being 
processed is prefixed to the message such that the message that 
appears is of the form 

SFP/STS UNKNOWN DEVICE NAME/TYPE. 

All errors except NET, NMS, BET, and IMN are considered fatal and 

abort the control point through the ABTM monitor function after 

issuing the message. The nonfatal errors drop the PP after 
issuing the message. 
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MONITOR CALL ERRORS 



.. a 4 + ar . a pi r> search has failed to yield a 
SFP is called after a PLD searcn "d „„„«.« * nR thp Lo 



Since SFP is caueu «.«.«. = . ~- I'^t SFP contains the logic 
m atch on the desired PP program request ^ S ^ P <°% . pd the des ? re 
to process monitor call errors. P / ith error co de PC 
routine in its function table, 2SH is caliea 



, a distinction is made for RA+1 




the di agnos 1 i c 



MONITOR CALL ERROR. 
If no RA is present, the request was made through a PP input 
register. The diagnostic 

xxx, NOT IN PP LIB. 
CALLED BY yyy. 

is issued and the PP is dropped. In all other cases the 
d i agnos t i c 

xxx NOT IN PP LIB. 
is issued and the control point is aborted. 

POP REQUEST 

tkp doo reouest is processed by overlay 2SI, extract error text. 

r cTs Tessas from spec i a I ly-c reated system text deck, to 
aid in analyzing error conditions resulting from product set 
execution! By using an error number and the proper system t ex 
deck an error diagnostic is transmitted to a specific CH buffer 
ana/or issued to the dayfile. All system decks to be used with 
D00 must reside on mass storage. 



The RA+1 call for D00 has the following format. 



59 



41 



17 



RA + 1 



DOO 







addr 



addr 



Address of 2-word table 
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The format of Location addr is as follows. 



addr+O 



+ 1 



59 




47 


35 


23 


17 


5 


a 


msg 


bufsize 


bufaddr 





text deck name 


insert 



a destination 

4QQ0B If insertions to messages 
2000B If dayf i le message transfer 
1000B If CM buffer message transfer 

msg Number of the message to be transmitted 

bufsize Size of CM buffer to receive message 

bufaddr Address of CM buffer to receive message 

deck Name of text deck containing message 

insert Data to inserted into message 

The response to the D00 request is received at the address 
specified in the call in the following format. 



59 



23 




addr 



status 



status 



Response status: 



If transmitted to dayfile only 
7777 If error 

other Number of CM words written if CM buffer 
t ransmi ttal 



Completion bit; set to 1 when function is completed 
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FIN REQUEST 

The FIN request is processed by overlay 2SI. Processing 
consists of translating the request into the appropriate CPM or 
LFM function request and reissuing it. The RA+1 format for the 
FIN request is as follows. 



RA + 1 



59 




41 


35 


29 


23 


17 







FIN 


20 





fc 





addr 



f c Funct ion code : 

01 FILINFO 

02 ACCSF 

03 ENCSF 

04 GETJCI 

05 SETJCI 

addr Address for corresponding function 
Any other value of fc results in the following message. 
SFP - ILLEGAL FUNCTION CODE. 



60454300 A 



30-15 



NETWORK VALIDATION FACILITY (NVF) 



31 



NOTE 

This section has been 
transferred to the NAM 
IMS (publication number 
i n preface) . 
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KRONREF, COMMON DECKS, AND SYSLIB 



32 



This section describes KRONREF and comm 
system old program Library <0PL>. 



on decks defined on the 



KRONREF 



«« +•« inrate a particular use o 
KRONREF is used by '!«• Pro«r« » e,t pp'package. 
a symbol, type, error flag, common deck, 

KRONREF generates a " — "^Im' Mbr!^ "^ name^r" 01 * 
^^s d :n k t h rOP L r r : f ^^: 9 dTo r L ;^:: y dec k s tbat referenced 



prog 

the foUowin 



pp direct ceLL Locations 

PP resident entry points 

Monitor functions 

Central memory pointers (in Low core) 

Central memory locations (in low core) 

Control point area words 

Dayfile message options 

File types and mass storage constants 

job origin types, queue types, and prioritie 

Error flags referenced 

Miscellaneous NOSTEXT symbols 

Common deck calls 

PP packages called * 

Special entry points 

System macro request references 



-j~«* nnt aenerate code to RJM to EXR, 
Macro EXECUTE nme = f oe I"2* k S a reference for KRONREF to u 
but is used exclusively to make a rererei 



se 
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The KRONREF control statement format is as follows: 
KR0NREF(P=lfn1,L=lfn2,S=lfn3,G=lfn4) 



P=lfn1 OPL input from file lfn1. If the P 

option is omitted or P alone is specified, 
file OPL is assumed. 

L=lfn2 List output on line lfn2. If the L option 
is omitted or L alone is specified, file 
OUTPUT i s assumed. 

S=lfn3 System text from overlay lfn3. If the S 

option is omitted or S alone is specified, 
file NOSTEXT is assumed. 

G=lfn4 System text from local file lfn4. If the 
G option is omitted, the system text is 
acquired as specified or defaulted by the 
S option. If G alone is specified, the 
local file TEXT is used. Use of the G 
option overrides any S specification. 



COMMON DECKS 

A system common deck is a COMPASS subroutine or group of macro 
or symbol definitions that have been tested, optimized, and 
designed to interface with the operating system. Common decks 
are used to increase efficiency in writing code, to ensure 
uniformity of code, and to decrease debugging time. 

The NOS common decks are organized in the following classes. 

CPU common decks 

PP common decks 

Equivalences 

Table management 

Display rout i nes 

TAF common decks 

Mass storage common decks 
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. , ,„ -identified by the name COMxnnn, where x is 
1SS lS??:? n >?Sn1f;*ng "the type o? common deck as follows: 



C 
I 
P 
s 

T 
M 
D 
B 
K 



The 3-character desig 
used in the common deck. 



siani f i cance 
CPU common deck 
Product installation configuration decks 

pp common deck 

Equivalences (subsystem symbols, constants, 
etc . ) 

Table definitions 
Mass-storage common decks 
Di splay rout i nes 
TAF data manager 
Transaction subsystem 
ignator nnn usually indicates the entry point 



COMMON DECK USAGE 



Common 
COMPMA 
the sy 
The mo 
CPCOM. 
i n sys 
wri tte 
def i ni 
a comm 
c ommon 
ope rat 



decks of 
C. These 
stem prog 
st freque 
The mac 
terns text 
n wi t hout 
t i ons . In 
on deck o 

deck or 
ion requi 



par 

com 

r amm 

nt ly 

ros 

PSS 

the 

ei t 

r in 

syst 

red 



ticular interest are COMCCMD, COMCMAC, and 
mon decks contain macros generally used by 
e° in system-origin jobs and PP routines, 
"used macros are defined in SYSTEXT through 
defined on COMCMAC and COMCCMD are also define 
TEXT. Thus the majority of programs can be 

need for calling a special common deck of mac 
her case, whether the macros used are defined 

a systems text, the program must call the 
ems text that contains the code to perform the 
by the macro. 



ro 
i n 



Most CPU system macros r.qulr. that the co-.on d.ek related to a 

function processor be aval able in ^e program howe , 

common decks need not specifically be c *^ e ° °y * specif y entries 

r it i: 9 mon e der k r b as%rernat%m:ts: l ^h:nth:sr r^locat ble 

to common decKS as e*Lcina«. 7 ^^ f h _- rio= and 

■ „,j ar i thp routines required tsucn as> uxw «..<- 
subroutines are loaded, tne routines ^ H 

3 uu i uu «. cvci tr The routines in SYSLId are 

LFM-) are satisfied from SYSLIB. i ne rout 

I i sted in this section. 

~* , a i„r a tahLe or if the desired common deck is 
If a program is not r ^°' at t ^ le c0 °^ deck mus t be accessed from 

use the COMPASS pseudoi nst rue t i on XTEXT. 
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To obtain detailed documentation on a particular group of 
common decks, assemble the deck CALLxxx from the system OPL 
where xxx denotes the following. 



x xx 

CPU 
PPU 
SYS 
DIS 
TAB 



Descri pt i on 
CP common decks 
PP common decks 
Equi va lences 
Di splay rout i nes 
Table management routines 



The following are OPL 
Common Deck 
COMCMAC 
COMCARG* 
COMCARM 
COMCCDD* 

COMCCDM 
COMCCDP 
COMCCFD* 
COMCCHD 

COMCCIO* 

COMCCMD 

C0MCC00* 

COMCCPA* 

COMCCPM 

COMCCPT* 

COMCCVI 

COMCCVL 

COMCDXB 



common decks. 

Desc ri pt i on 

CPU system macros 

Process arguments 

Multiple- word argument processor 

Constant to decimal display code 
conve ps ion 

CPU debugging macros 

CPU debugging package 

Constant to F10.3 conversion 

Constant to hexadecimal display code 
conversion 

I/O function processor 

Central program macro definitions 

Constant to octal display code conversion 

Convert positional arguments 

Control point manager processor 

Copy pref i x table 

User control limit formula 

Common validation interface processor 

Display code to binary conversion 



♦This common deck is also available on the COMPASS program library 
(PL). 
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Common Deck 
COMCECM 
COMCECS 
COMCEDT 
COMCFCE 
COMCFQO 



Description 
ECS interpretive mode macro definitions 
ECS interpretive mode macro processor 
Edit date or time from packed format 
Format catalog entry for output 
Format queued file output 

xadecimal display code to binary 



COMCHXB He 

conve rs ion 



COMCIQP 
COMCLFM 
COMCLOD 



IQFT file processors 
Local file manager processor 
User call loader interface 
COMCMTM* Managed table macros 
COMCMTP* Managed table processors 
COMCMVE* Move block of data 



COMCOVL 
COMCPFM 
COMCPFU 
COMCPOP 
COMCQFM 



Overlay load processor 

Permanent file processor 

Permanent file utility function processor 

Pick out parameter 

Queue file manager processor 
COMCRDC* Read coded line, -C- format 
COMCRDH* Read coded line, -H- format 
COMCRDO* Read one word 

COMCRDS* Read coded line to string buffer 
COMCRDW* Read words to working buffer 

COMCRSP Remove secure parameter from control 
statement 

COMCRTN Read terminal network description 
COMCSFM System file manager processor 



COMCSFN* Space 



fill right-justified ze 



ros 



•this common deck is also available on the COMPASS PL. 
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Common Deck 
COMCSNM 
COMCSRT* 
COMCSSN 
COMCSST* 
COMCSTF* 
COMCSYS* 
COMCUPC* 
COMCUSB 
COMCVFE 
COMCWOD* 
COMCWTC* 
COMCWTH* 
COMCWTO* 
COMCWTS* 
COMCWTW* 
COMCZAP 
COMCZTB* 



Desc ri pt ion 
Set name in message 
Set record type 
Skip sequence number 
Shell sort table 
Set termi na I file 
Process system request 
Unpack control statement 
Unpack data block to string buffer 
Validate FNT/FST entry 
Convert word to octal display code 
Write coded line, -C- format 
Write coded line, -H- format 
Write one word 

Write coded line from string buffer 
Write words from working buffer 
Z argument processor 
Convert zeros to blanks in a word 



The following are PP common decks. 

Common Deck Desc ri pt i on 

COMPMAC PP system macros 

COMPACS Assemble character string 

COMPANS Assemble numeric string 

COMPCDI Clear local MST utility interlock 

COMPCEA Convert FCS address 

COMPCFP Clear format pending 

COMPCHI Redefine I/O instructions 



*This common deck is also available on the COMPASS PL. 
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Common Deck 
COMPCHL 
COMPCIB 
COMPCKP 
COMPCLD 
COMPCLX 
COMPCMA 
COMPCMX 
COMPCOB 
COMPCRA 
COMPCRS 
COMPCTI 
COMPCUA 
COMPCUN 
COMPCUT 
COMPCVI 
C0MPC2D 
COMPDMS 
COMPDTS 
COMPDV5 
COMPECX 
COMPFAT 
COMPGBN 
COMPGJN 
COMPGTN 
COMPIFR 
COMPIRA 
COMPMRQ 



Desc ri pt ion 
Redefine I/O instructions 
Check input buffer 
Set checkpoint bit in EST entry 
Search central Library directory 
Clear exchange package 
Central memory available on recovery 
Computer maximum field length 
Check output buffer 
Convert random address 
Check recall status 
Clear track interlock 
Check user access 
Compare user numbers 

Clear permanent file utility interlock 
Convert validation indexes 
Convert two octal digits to display code 
Determine memory size 
Determine track interlock status 
Divide by five 

Compute ECS maximum field length 
Search for fast attach file 
Generate banner name 
Generate j ob name 
Generate terminal number 
Set/clear flag register interlock 
Initialize random access processors 
Monitor request 
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Common Deck 
COMPMSD 
COMPRBB 
COMPRCB 
COMPRCS 
COMPREI 
COMPRJC 
COMPRLS 
COMPRNS 
COMPRSI 
COMPRSS 
COMPSAF 
COMPSCA 
COMPSCE 
COMPSDI 
COMPSDN 
COMPSEI 
COMPSES 
COMPSFB 
COMPSFE 
COMPSFI 
COMPSFN 
COMPSNT 
COMPSPA 
COMPSRA 
COMPSSE 
COMPSTA 
COMPSTI 



Description 
Mass storage processor for 3553-1 
Read binary buffer 
Read coded buffer 
Read control statement 
Request ECS increase 
Read job control word 
Re lease storage 
Read next sector 
Request storage increase 
Read system sector 
Search for assigned file 
Set catalog address 

St atus / cont ro I register error processor 
Set local MST utility interlock 
Search for device number 
Search for end-of-i nf ormat ion 
Set error status in local MST (STLL) 
Set f i Le busy 
Set family equipment 
Set FNT interlock 
Space fill name 
Set next t rack 
Set pot address 
Set random address 
System sector error processor 
Set terminal table address 
Set track interlock 
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Common Deck 
COMPSUT 
COMPTGB 
COMPTLB 
COMPUPP 
COMPUPS 
COMPUSS 
COMPVFC 
COMPVFN 
COMPVMS 
COMPWBB 
COMPWCB 
COMPWEI 
COMPWSS 
COMPWVE 
COMPREL 
COMPRLI 
COMPCHL 
C0MP3XD 



D esc ri pt i on 
Set permanent file utility interlock 
Set/clear global MST flag CACGL) 
Set/clear local MST flag CSTLL) 
Update pot pointer 
Unpack statement 

Update system sector for disposable files 
Ve ri f y forms code 
Verify file name 
Validate mass storage ordinal 
Write binary buffer 
Write coded buffer 

Write EOI sector 

Write system sector 

Write and verify with EOI sectors 

Location free overlay macros 

Relocatable overlay macros 

Redefine I/O instructions 

3000 • equipment driver subroutines 



The following are display common decks. 

Common Deck Description 

COMDDIS Display subroutines 

COMDDSP Display program routines 

COMDSYS Display system status and associated 
rout i nes 

COMDTFN Table of monitor functions for display 
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The following are mass storage common decks. 
Common Deck Description 

COMMMSD Universal mass storage driver 

COMMMSE Mass storage error processor 

The following common decks contain subsystem equivalences, 
symbol definitions, and constants. 

Common Deck Desc r i pt i on 

COMSACC User file equivalences 

COMSBIO BATCHIO equivalences 

COMSCIO CIO/driver equivalences 

CGMSCPS CPUMTR subfunction codes 

COMSDSL Deadstart load parameters 

COMSESS Engineering services support definitions 

COMSEVT Event descriptor formats 

COMSEXP EI/200 tables and constants 

COMSIOQ Dayf i le/queue protect equivalences 

COMSJCE Job control equivalences 

COMSJIO Job input/output equivalences 

COMSJRO Job rollout equivalences 

COMSLDR CPU program loading equivalences 

COMSLSD Label sector definition 

COMSMMF Mu It imai nf rame equivalences 

COMSMRT Machine recovery equivalences 

COMSMSI MST/PP equivalences 

COMSMSP Mass storage processing equivalences 

COMSMST MST f lag / i nt e r I oc k definitions 
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Common Deck 
COMSMTR 
COMSMTX 
COMSNCD 
COMSNET 
COMSPFM 
COMSPFS 
COMSPFU 
COMSPRD 
COMSPRO 
COMSQFS 
COMSREM 
COMSRSX 
COMSSCP 
COMSSCR 
COMSSFS 
COMSSRU 
COMSSSE 
COMSSSJ 
COMSTCM 
COMSTDR 
COMSTRX 
COMSWEI 
COMSZOL 



Description 
MTP/CPUMTR equivalences 



Magnetic tape e 



xecutive equivalences 



Network communications definitions 

Terminal network equivalences 

Permanent file equivalences 

Permanent file supervisor equivalences 

Permanent file ut i I i ti es equivalences 

Priority definitions 

Project profile file structure 

Queued file equivalences 

IAF/TELEX system parameters 

Resource executive equivalences 

System control point equivalences 

S/C register equivalences 

SFS equivalence and table definitions 

Define SRU parameters 

System sector equivalences 

Special system job parameters 

TELEX communications micros 

Terminal driver equivalences 

Transaction subsystem equivalences 

EOI sector definitions 

Zero-level overlay lengths 
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The following common decks contain tables used by the system 
Common Deck Desc ri pt i on 

COMTBCD Display code to BCD 

COMTDPC BCD to display code 

C0MTDP6 Display code to 026 punch 

C0MTDP9 Display code to binary 029 punch 

Common Deck Description 

COMTNAP Define application access bits 

COMTVXD ASCII/display conversion table 

C0MT6DP 026 punch to display code 

C0MT9DP 029 punch to display code 
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SYSLIB 

The following common decks, unless otherwise noted, are assembled 
from the COMPASS PL and are available in relocatable form in 
SYSLIB. 



Common Deck 



Description 



COMCCIO I/O function processor 

COMCCPM* Control point manager processor 

COMCECS* ECS interpretive mode macro processor 

COMCLFM* Local file manager processor 

COMCMVE Move block of data 

COMCOVL* Overlay load processor 

COMCPFM* Permanent file 

COMCRDC Read coded line, -C- format 

COMCRDH Read coded line, -H- format 

COMCRDO Read one word 

COMCRDS Read coded line to string buffer 

COMCRDW Read words to working buffer 

COMCSYS Process system request 

COMCWTC Write coded line, -C- format 

COMCWTH Write coded line, -H- format 

COMCWTO Write one word 

COMCWTS Write coded line from string buffer 

COMCWTW Write words from working buffer 



♦Assembled from the system OPL 
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EXPORT/IMPORT 



33 



INTRODUCTION 

, T + rc/n .ubsvstem controls communication between 
The Hxport/I-port <E/I> subiyste- ^ ^ ^ 20Q Js 

NOS and remote b « teh T ** r "J"" /i ; p0Pt subsystem is also referred 
Termina protoco . The » Qr hard - w1red terminals 

at tine speed; of 2000° l*5S, or 4800 bits per second with the 
BCD character set. 

E/I 200 PROGRAMS 

The E/I 200 subsystem consists of the following routines. 

• E200CP, a CPU program 

• 1LS, a transient PP routine 

• 1ED, a dedicated PP routine 

• XSP, a transient PP routine 

E200CP is the CPU program that handl - -formatti ng of d.t. to 

and from the remote terminals. Its field Leng his 

for all communication tables and FETs for the suDsystnn. 

/ M ed to establish the constants, pointers, and 

deck C0MSEXP is used to es illustrates the general 

communication table areas. i<au<.c 
layout of these areas. 

A tocal resident peri phera I li brary (RPL) for th. , 1L| | ov.rl.y. 
is contained in the E200CP field length The F E a bur 
are kept in the upper portion of the FL so that the FL may 
expand and contract as the need arises. 



Routine 1LS is a transient PP program that Processes terminal 

omm nds assigns files, performs functions or and 
functions as the executive routine for the subsystem. 

Routine 1E0 is a dedicated PP program that controls ,_.„,, , 
communications between the system and the remote batch te™ inaLs 

" E » must service the 6671 multiplexer at a ™« "«* 
enough to ensure that no data loss occurs f or the hi ghest speed 
Line connected. The program does data conversion of the 

nput/ouSput'data to'and from the display code used i nterna I to 
the rest of the system. Routine 1ED must get E200CP out ot 
autorecaU when there are buffers to be filled or emptied. 

XSP is a transient PP program called by 1LS to perform certain 
time-consuming tasks. 

The preceding routines are discussed in detail later in this 
sect ion . 
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E/I 200 OVERVIEW 

Figure 33-1 details E/I 200 interaction between E2Q0CP, 1LS, 1ED, 
XSP, and the remote batch terminals it services.* Figure 33-2 

illustrates the sequence of operations and data flow for a job 

using the subsystem. E/I 200 can service up to sixteen 2400 bps 

terminals. For each terminal E/I 200 logically maintains the 
table shown in figure 33-3. 



TABLE 33-1 . E/I CM LAYOUT 



Loca t i on 



Description 



RA + 
through 
RA + 22 



DRCL 

TFS 

MSGB 

LINF 

CPIK 

DPJT 

JST 

FAMT 

QAPB 

FAL0C 



Pointer table. The following locations 
contain the indicated pointers. 



Loca t i on 


Poi nter 


2 


FETs and Buffers 


3 


TFS 


4 


MSGB 


5 


LINF 


6 


CPIK 


7 


DPJT 


12 


JST 


13 


FAMT 


14 


UNJC 



E200CP autorecall word set by 1ED when 
activity needed . 

Function/status table (2 words per port) 

Message buffer area (4 words per port). 

Login table (2 words per port). 

CPU interlock table (1 word per port). 

Drop job table (1 word per port). 

Job statistics table (1 word per port). 

Family name table (1 word per port). 

QAC parameter block. 

E200CP code. 

Beginning of dynamic storage. 

Allocated FETs and buffers. 
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Export 

Control 

Point 



control 
tables 



E200CP 
control point 
data handler 



local 

overlay 

library 



allocated 

FETs and 

buffers 



XSP 

Export 

service 

processor 



Export 
Subsystem 



I 



1LS 

export 

executive 



J 



1ED 
6671 
driver 



XQACX 



Data channel 




printer 



6671 
MUX 



data 
set 



T 
1 




200 

user 

terminal 



input/ 
output 
queue 



f 



1 of 16 ports 



display \ 
terminal / 



card reader 



Figure 33-1. E/I 200 Interaction 
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EI200 
Control Point 



E200CP 



OUTPUT FET 



buffer 



czz 




E200CP reads the output file via CIO into the output FET buffer 



Figure 33-2. E/I 200 Operation 
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FNT 



FST id eq 




. . nn to write the data from the input FET buffer to 
E200CP calls CIO to write me 

t he d i sk . 




pag 



*^w anH calls OBP to create a banner 
1LS finds an output queue entry and calls 
oaae in the output FET buffer and informs E200CP. 

Figure 33-2. E/I 200 Operation (Continued) 
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MUX 



EI200 
Control Point 



RA+DRCL 




SET *0 



E200CP 



line buffer 



EI200 
Control Point 





calls / 


E200CP 


*\ 






line buffer 










1ED reads from multiplexer to 
line buffer and sets RA+DRCL 
words to nonzero- This takes 
E200CP out of autorecall. 



E200CP calls 1LS 
i nto autoreca 1 1 . 



and goes 



FNT 
FST 



jobname 


EI200 


INFT 


CP=0 


id 


eq 


% 


V/////////////M 


WMW, 



EI200 
Control Point 



RA+W.INT 







SET*0 


* / 


* \ 






E200CP 








line buffer 









EI200 
Control Point 





1LS sets RA+W.INT to nonzero, 
which takes E200CP out of auto- 
recall. 1LS calls XSP to 
create an FNT/FST input queue 
entry for the job in the line 
buffer, using OBF and OVJ to 
crack the job card. 



E200CP reformats the line 
buffer data as 1ED passes 
it and moves the data to 
the input FET buffer. 



Figure 33-2. E/I 200 Operation (Continued) 
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0- 



EI200 
Control Point 



E200CP 



OUTPUT FET 



buffer 



line buffer 




tz 



MUX 



1ED 



EI 200 
Control Point 



E200CP 




OUTPUT FET 



buffer 



line buffer 




C 



E200CP formats the output FET 
buffer for the remote printer and 
i nf orms 1 ED . 



1ED sends the Line buffer 
data, one Line at a time, 
to the remote printer. 



MUX 



-•/lED J 



EI200 
Control Point 




E200CP goes into autorecaLL 
and 1ED continues to po L L the 
muLt ipLexer. 

Figure 33-2. E/I 200 Operation (Continued) 
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UNJC 



QAPB 



nine-word 
parameter block 



input FET 



output FET 



Figure 33-3. Port Table Layout 
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E XPORT/IMPORT COMMUNICATION AREAS 

ragraphs detail the comm 



The following pa 



unication areas shown in 
s uc <. a ■ v ». ■•'• p^nnrp field length and 
figure 33-3. These tables are i h "^^ ^ f the subsystem, 
are used as communication areas for all parts 



A rea 

TFS 

MSGB 

LINF 

CPIK 

DPJT 

PWLT 

FAMT 



Description 
Funct ion/ status table 
Message buffer 
Login information table 
CPU interlock table 
Drop job table 
Pas swo rd table 
Fami ly name tab le 
Export/Import FETs 



FUNCTION/STATUS TABLE 



*. ui„ z-tcc^ ic uQPd bv 1ED to issue function 
The function/status table (TFS) is used oy 

requests to 1LS. Its format is as follows. 



59 



47 



35 



23 



TFS 



function 



terminal 



eq, no. 



unused 



funct ion 



Functions are set by I/O driver 1ED to 
communicate with 1LS; defined in the 1LS field 

length and in COMSEXP 

function Description 

00 Null function 

02 Message from terminal 

04 Print block complete 

06 Special end read 

^0 Write message complete 
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t e rmi na L 
eq no 



D.esx ..r.i pt ion 
MuLtipLexer not available 

Multiplexer not 
opera t iona I 

Initialization complete 

Terminal connected 

Printer not ready 

Message read error 

Terminal disconnected 

Operator interrupt 

Read E3, no EOF* 

Read E3, with EOF* 

Read E2, no EOF* 

Read E2, with EOF* 



Site address of logged-in terminal 

Equipment number of multiplexer assigned; this 
field used in entry only 



function 


12 


14 


16 


20 


22 


24 


26 


30 


32 


34 


36 


40 



* E1, E2, and E3 are hardware functions set by both the card 
reader and printer. They are specified in the appropriate E/I 
200 hardware manual. 
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I/O status CPU I/O status from 1LS: 

status Description 



0001 

0002 

0004 

0010 

0020 

0040 

0100 

0200 

0400 

1000 

2000 

4000 



Run CPU (output, coded mode) 

Run CPU (input, coded mode) 

Print Line Limit exceeded when set 

Ini tiaLi zation in progress 

XSP initialization required flag 
(output) 

Return sequence number 

Output f i le active 

Input f i le active 

Not assigned 

Output file suspended 

Read, wait for operator GO 

If 0, read E3, if 1 , read E2 (on 
p revi ous read) * 



»~il~~E2, and E3 are hardware functions set by both the card 
reader and Printer. They are specified in the .ppropM.t. E/ 



200 hardware manual 
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I/O drive Driver status to 1ED from 1LS: 



s tatus Desc ript ion 

0001 Terminal on-line 

0002 Terminal logged-in 

0004 Interrupt during print transmission 

0010 Interrupt during read transmission 

0020 Not assigned 

0040 Not assigned 

0100 Execute print control program 

0200 Execute read control program 

0400 Execute write message to terminal 
s c reen 

1000 Not assigned 

2000 Not assigned 

4000 Not assigned 



MESSAGE BUFFER 



Each message buffer (MSGB) is four CM words in length. The 
messages to and from the remote terminals are placed in the 
appropriate message buffer with a 0000 termination byte. 

LOGIN INFORMATION TABLE 

The login information table (LINF) contains two words per 
terminal. This table is used by XSP to respond to 1LS. Its 
format is as follows. 



LINF 



59 




35 




17 


11 O 




user number 






1 


hashed job name 


user index 


status 



user index 



User index; if zero, indicates illegal user 
number 



60454300 A 



33-12 



status 



Status of terminal: 

status Description 

Login act i ve 

1 Login complete 

2 Request PP again (system busy) 

3 Duplicate user number 



CPU INTERLOCK TABLE 




Its format is as follows 



CPIK 



59 


Z3 


11 


unused 


INPUT 
active 




OUTPUT 
active 







DROP JOB TABLE 



he drop job table (DPJT) contains the password at login. At 
ther ?imes it contains status responses in the following format 



59 



DPJT 



internal system job name 



17 



status 



status 



Response status: 

status Desc ri pt i on 

0000 Entry available 

0001 QAC called and active 

0002 QAPB in use 

0003 PP not available 
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PASSWORD TABLE 

The password table (PWLT) uses the same Location as DPJT. At 
login time, this table is used for the user password instead of 
drop j ob. 

FAMILY NAME TABLE 

The family name table (FAMT) at login time is used for the 
user' s f ami ly name . 

EXPORT/IMPORT FETs 

E/I 200 creates a FET for each terminal that is logged in. The 
formats are shown in figure 33-4. 
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INPUT FET 



FET + O 



internal system name 



FNT address 



full /empty 
driver flag 



job card processing 
in progress 



job sequence number 



address of line 
following EOR 



job priority 



job time limit 



jobFL 



code/status 



FIRST 



IN 



OUT 



LIMIT 



address of line 
following EOF 

pointer to next 
allocated FET 



card count 



OUTPUT FET 



FET+O 



internal system name 







FNT address 



full/empty 
driver flag 



dayfile 
first track 



dayfile 
first sector 



01 



job sequence number 



print line count 



code/status 



FIRST 



IN 



OUT 



LIMIT 



pointer to next 
allocated FET 



Figure 33-4. Export / Import FETs 
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PROGRAM E200CP 

The central processor portion of E/I 200 is used for 
processing of data to and from the remote site. 



the 



Data being received from the remote site card reader is placed 
in the line buffer allocated to the active terminal by the I/O 
driver program. The I/O driver, 1ED, strips off the protocol 
header and trailer. The data is converted to display code and 
written, one card image at a time, into the line buffer. When 
the I/O driver senses an end of message code, the CM line buffer 
is marked full so that E200CP processes that data at the next 
opportunity. Trailing blank suppression and detection of 
end-of-record and end-of~file is accomplished by E200CP. 

Transmission of data to the system allocatable mass storage 
device is also requested by the E200CP. 

The buffer space for an output file is allocated by the 
executive program 1LS. The banner page data is placed in the 
circular buffer by the executive program 1LS. All subsequent 
I/O requests are issued by the E200CP program. Data from the 
circular buffer is compressed according to the 200 User Terminal 
specification and placed into the line buffer for transmission 
to the terminal. As much data as possible is placed in the line 
buffer on each cycle. A full line buffer is not always possible 
to generate because the print line cannot be split between 
messages . 

The control for the CPU program is a switched circular scan of 
the terminal control table. Switching is performed by the 
executive via the status word in the funct ion/ status table. 
Control interlock is through the CPIK table within CM. Every 
complete scan attempts to complete an entire operation on every 
active terminal. When an entire scan is completed. E200CP goes 
into autoreca 11. 

The following common decks are called by E200CP. 

Common Deck Description 



C0MCCI0 
COMCRDC 
COMCWTH 



I/O function processor 
Read coded line, C format 
Write coded line, H format 



COMCSYS Process system request 

COMCRDW Read words to working buffer 

COMCWTW Write words from working buffer 

COMCMAC CPU system macros 

COMCCPM Control point manager processor 

COMSEXP E/I constant definitions 
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,, c • * -flowchart of the main scanner control portion 
:; 9 E200CP: The foUowing paragraphs discuss Export/ I.port 
processors INP and OUT. 
IMP - INPUT DATA PROCESSOR 
The following functions are performed by this program. 

4.u« n nfi huffer into the file cirular 
. Moves data from the I "• ^[J^ 1 1 n the process, 
buffer, removing trailing blanKS i n w 

«.*<*«. ma<5<; storage device using 
• Writes data to the system mass storey 

CIO and standard I/O techniques. 

. Senses and processes end-ol f-reco rds An^EO R is ^ 
indicated by a block of •J-flJt -ords in t ^^ 
containing the character *- E ° R - ™ 1S zero of bLo ck word 
(30B) is defined in COMSEXP in Dyxe 

j „<_jii» An EOF is indicated 
. senses and processes end-of " f ^«- *" t u f ier 

by a block of eight "" \' . h 2 'i " »ro .f 
containing the character K.EOF <27B) ^ y 

' Soro^oc doernorcon: a ^n r an f EO^ J code Czero, end^of 

:v.r. , .;-5-s:; d / b t i h o: k b ; a n , y B B ^ $?:? vat..*. 

by?e one nonzero, and does not alter byte zero 

S'jyu :r.:;'i;.^: ss's.sr . .: ' 

processed the input file. Processmg of data then 
continues at the block address stored in FET+5, bits 
17 through 0. 

. Senses and processes -d-of-message . ^ ™J 1 . 
indicated by byte zero of • JLock Cor sp ec 
word) containing the character K.EOM uj; in oy 
The full/empty status (byte zero) of FET + 5 is set 
empty and normal data processing continues. 



These special values are as follows. 



Character 
K.EOR 
K.EOF 
K.EOM 
K.EOI 



Value 
0030B 
0027B 
0000B 
0055B 



They are specified in the COMSEXP comm< 



in deck . 
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OUT - OUTPUT FILE PROCESSOR 

Data from the circular buffer is placed into the line buffer by 
this phase of the E200CP program. 

Strings of blanks greater than two characters in length and up 
to MAXB characters are replaced by a two-character compression 
set. Strings greater than the maximum length are processed as 
one or more strings of maximum length and a remaining short 
string if necessary. End-of-line codes are placed on every line 
sent to the remote printer. Only complete lines are placed in 
the line buffer and lines of more than 136 characters are 
treated as more than one line, but some characters may be lost. 

An attempt is always made to fill the line buffer with the 
maximum number of characters allowed. A restriction of the 
terminal hardware forces a full line to be transmitted before an 
end-of-message. This means that not all transmissions are 
maximum length. 

The 200 User Terminal has three buffers; the screen, card reader, 
and printer. The screen buffer is used for transmission to the 
multiplexer; consequently card images are transferred from the 
card reader buffer to the screen buffer for transmission to the 
multiplexer. Similarly, output is transmitted by the multiplexer 
to the screen buffer, and is then transferred to the printer 
buffer for printing. 
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Figure 33-5. E200CP Control Scanner 



60454300 A 



33-19 





■WSCAN 



clear DRCL 

recall bit, 

recall on DRCL 



recall 



restore 1LS 
input register, 
clear recall bit 




© 




Figure 33-5- E200CP Control Scanner (Continued) 
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1LS - EXPORT/IMPORT EXECU TIVE ROUTINE 

, A1(fl ,.|l until 1ED sets RA+DRCl to 1, 
E200CP waits in -"tojec. U 11 ^ ^^ terminaL . 

indicating some input was ^ c ^^ autorecall until 1LS is 
E200CP calls 1LS to a PP a "? J°f *, ." ™ he input or output, 
ready for E200CP to begin processing tne '"w 

j «* *w« fnLLowing overlays at anytime, 
Routine 1LS may load any of the Tonowiny 

depending on the action required. 

j. • - <i i c Mnaded-by system) loads 

• initial load. Routine 1l "S CloadeO oy y nt8 

executive subroutines at 7000B . Th *** (1LS and 
are expected to be resident at all times 
OVRS in memory. 

TU -funrtion Drocessor segment 

• Function processing. The f unct ion pr^ 

is loaded if any outstanding functions from the 
iriver are found C1LS, OVRS, and OVFP in memory). 

Iflh fUe nrocessing. The enter queue segment is 
' uadli if functlon'processing found any outstandnng 
input activity C1LS, OVRS, OVJF). 



"";;;.;;.; ":,. ■>»*. «««. •*< >-«>"' »•' ,n 

memory) . 



if 



• sra-„-;s:s:!*;., T K,K: r s:.r;: , ::.!:.ia d fl u . 

OVRS, and OVCS in memory). 

Any number of the preceding actions could occur during an 

executive pass. 

~„«.«^ +•« ho 3000 tYDe equipment (ST). If a 

The EST entry is expected to be iuuu type _m 5 efinition of 

different equipment type code is desired, the detimt 
MUXDT in the I/O driver must be changed. 

Thp EST entry is located by the multiplexer I/O dri ver .P^ ^ 9 ™; 
The EST entry is <.uv.au^« / n *nnt*r tvne which is not 

The search finds the first entry of the P™P er e 
set off or assigned to another control point. The Ebi 
as follows. 



59 



52 



cp 
no. 



47 



41 



ch. 
no. 



35 



23 



11 8 5 



device type 



eq. 
no. 



utive overlays are stored in 



U of the -rmally used executive oer,,...^^ m 

entral memory within th ? *; e "_^™ increases the load speed 
uring initialization. This techn 9"* n t s of CMR space if 
f the PP executive without using large amounts 
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E/I 200 is not Loaded. For this reason, the programs and 
overlays associated with E/I 200 should be disk resident. The 
only part of E/I 200 that must be CM-resident is the short 
executive main program, 1LS. 

The local RPL map is identical in format with the system RPL. 
Starting at the address in pointer word P. RPL, a zero word ends 
the library. 

The routines in the library are: 

• 9IA overlay 0VFP. Function processor, when 1ED 
communicates with 1LS via the TFS table. 

9 9IB overlay 0VFA. Searches the FNT for files to be 
printed at the remote sites. If any such files are 
found, a buffer is allocated and the header 
information is placed in the buffer for the initial 
print operations. Subsequent data handling is 
performed by the central processor program associated 
with this system. It calls overlay 0BP to generate 
the banner page. 

• 9IC overlay OVJF. Job file processor called by 
executive main control to release completed job files 
to input queue and/or to initialize new job file. 

• 9ID overlay 0VCS. Central memory manager executes 
every few seconds in an attempt to reduce the amount 
of storage used by Export /Import central memory. 

• 9IE overlay 0VIN. The first time 1LS is called by 
E200CP, this overlay initializes all of Export/ Import 

• 9IF overlay 0VAB. All error modes, operator STOP, 
and error messages are processed by the abort E/I 
overlay. 

• 916 overlay 0VR0. Initialize resident library 
programs in control point FL area. Programs are 
stored in the same format as RPL system programs. 
Pointer P.RPG the address where this Library, begins . 

• 9IH overlay 0VRS. Resident subroutines used by the 
main segment and loaded into the upper portion of PP 
memory to allow for expansion of the main segment or 
any other overlay. 

In addition, the system overlay, 0BP (generate banner page) is 
used. Also, 1LS calls the following system programs. 



P rogram 
OOF 
1 AJ 



Desc ri pt ion 
Drop f i les 
Job advancer 



60454300 A 



33-22 



Program 
1DL 
CIO 
XSP 
QAC 



Desc ri pt ion 
Display overlay loader 
Combined input/output 
E/I service processor 
Queue f i le processor 



Figures 33-6 a 



nd 33-7 are flowcharts of the 1LS routine 



XSP - SERVICE PROCESSOR 



XSP is called by the Export/Import executive to assist In 
certain functions that require more ^ e ^.^^ %J e exe cutiv< 
available for individual processing tasks within 
The call to XSP is formatted as follows. 



59 



41 



35 



23 



11 



IR 



XSP 



cpno. 



parameters 



fc 



f c 



Function code: 

1 Validate user number CVUN) 

2 Make job entry CMJE) 



SP calls the following programs. 



Program 
OAV 
OBF 
OVJ 



Description 
Verify user number 
Begi n file 
Verify job and user cards 



XSP consists of the IVE (process 



function code) routine which 



XSP consists ■ - - called by E/I 200 and that the function 
tlllll n :ii?6 mTr.?:^ figure 33-8) then exits to either 



VUN or MJE. 

VALIDATE USER NUMBER (VUN) 




set to 000000. 
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The input register parameters for this routine include the table 
index of the user number received in bits 23 through 12 and the 
function code (V.CUN) in bits 11 through 0. 

The format of the request words are as follows. 



LINF 
PWLT 
FAMT 



59 




17 







user number 





password 





family name 



The format of the response word (returned in PWLT) is as follows 



59 



35 



PWLT 



11 



generated user code 


user index 


status 



status 



Status response: 

1 Returned for complete response 

3 Returned if user logged in 
before 

5 Returned if user not permitted 
access to the system (security 
count exceeded) 



MAKE INITIAL JOB FILE ENTRY (MJE) 

This routine calls OVJ to create the job card, assigns the 
sequence number, creates the FNT/FST entry, writes the system 
sector, and exits with the FNT address in FET+4 and the status 
in FET+0 set to 15B. 

The input register parameters for this routine include the scan 
index in bits 36 through 30 and the FET address in bits 29 
through 12. FET+0 contains the first four characters of the job 
name (hashed user index). FET+5 is the job card address. 
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LOV 

k load and execute 
OVJF 




LOV 



load and execute 
OVFA 




Figure 33-6 1LS - Executive Main Control 
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update 

various 

timers 




LOV 



load and execute 
OVCS 



set new start 

time for 

storage manager 

call 



1 



update time 
interval control 




RSI 



"** request storage 
increase 



set completion 

bit of 
input register 



( PPR J 



Figure 33-6 1LS - Executive Main Control (Continued) 



60454300 A 



33-26 



C fts ~) 



set function/ 
status pointer 




no 



load OVAB 
(abort overlay) 



i 



( "" ) 




initialize scanner 



^TS3^ 



read function and 

status words 

from CM 




load OFVP 
(function 
processor) 



execute function 




■*i FTS4 



advance 
scan index 



no s' all ports 
checked 




Figure 33-7 Function Table Processor 
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no 




issue 
dayfile message: 


* i 


i * 


ILLEGAL PP 
CALL (XSP) 






v 




/ ABTM \ 


no 


( monitor ) 



( PPR ) 



Figure 33-8. XSP - Main Entry 
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1 ED - MULTIPLEXER DRIVER 

; he .uitipi.x.r ^; :r6 p-- t ^ L :j: d ;^ t :s w ;?n; to 

designed to drive one 6671 ^ L ^P; eX devi ces with sim Uar 
sixteen 200 User Terminals or ^^er dev 24oo 

interface characteristics. The designee 



This p 
execut 
peri od 
necess 
storag 
Act i vi 
storag 
drop o 
ope rat 
the st 
peLeas 
to i nt 



rog ram 
ive and 
i cal ly 
ary , is 
e move, 
ty wi th 
e move 
f the E 
or stop 
op bit 
e the c 
e rna I c 



is in 
i s c 
check 
sues 
no r 
the 
becau 
II 20 
or s 
in st 
hanne 
odes 



i 1 1 a 
ont r 
s th 
a pa 
ef er 
term 
se o 
su 
ubsy 
atus 

I, i 
and 



lly Loaded 
oiled by t 
e system s 
use functi 
ences to c 
i na Is is n 
f i nterna I 
bsystem is 
stem ma If u 
word zero 
ts reserve 
vice versa 



by the E/I 200 subsystem 
hat executive. The driver 
torage move flag and, if 
on to the monitor. During 
entral memory are allowed, 
ot disrupted in most cases of 

buffering in the driver. If 

necessary (either because of 
notion), the executive must set 

to cause the 1/0 driver to 
d equipment, and stop. External 

are done via conversion tables. 



a 
an 



The folding are the major divisions within the driver program. 

. IED (control driver). Times the I/O cycles to the 
multiplexer. 

• I0S (input/output with multiplexer). . , 

Performs the actual input/output wi th th ju ^J*" 
when directed by the control driver and resets the 
reentry table addresses. 

. COS (control switch). Di rec t s the specif 1c a ctivi ty 
for each multiplexer port, initiates new activity as 
directed by the executive, and transfers control to 
the following reentrant routines. 

• CON (poll to connect multiplexer line). Probes each 

# ine with all addresses searching for a response . 
When a response is sensed, the executive 1LS is 
informed to login the terminal. 

. MSG (write message to display). When di rec ted by 1 LS, 
this section is activated to send one message from 
the message buffer to the remote display screen. 

. PRT (print on remote printer). When directed by 1LS, 
this section is activated to transmit one buffer 
block to the remote printer. Routine 1LS s informed 
at the end of each block so that end of output 
processing or remote operator directives can be 
processed if necessary. 

• RDC (read cards from remote card reader). One block 
of cards is read from the terminal and the 

p au function is issued to US to in or. it of 
more cards, last block, bad codes, and so on. 
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• STA (read operator's message). This, along with 
sense terminal condition, is used to process input 
messages from the remote device. The messages are 
placed in the terminal message buffer for translation 
by E200CP. Any action required by an operator 
message is initiated from 1LS. 

• STA (sense terminal condition). When a connected 
terminal is otherwise inactive, it is periodically 
checked for messages originating from the remote 
terminal or other action required by the remote 
terminal when not active. 



Figure 33-9 shows the 6671 multiplexer port data words. 
33-10 is a flowchart of the 1ED main loop. 



Fi gure 



6671 Input Word 
11 10 9 8 7 



8- bit data character 



character reject 
u - carrier on 
•— lost data 
•— valid character 



6671 Output Word 



11 8 


7 





I/O control 


8-bit data character 





Figure 33-9. 6671 Port Data Word 
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PRESET 
preset program 



AVC 



advance 

millisecond 

clock 




reset start 
time values 



I0S 



I/O driver 
section 



I 



compute 
new major 
cycle time 





update max 
cycle time 



read entry time 



n 



no 



Figure 33-10. 1ED Main Loop 
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(ZED 



set re-entry 

table addresses 

and beginning 

part number 



output data 

to 6671 for 

N.PORT ports 

12 bits/port 




input date 

from 6671 for 

N.PORT ports 

12 bits/port 





Figure 33-10. 1ED Main Loop (Continued) 
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reset recall 

time and read 

read recall word 




start CPU 



decrement 
control read 
cycle timer 





read control table 

and reset 

cycle timer 




decrement reentry 

pointers, load port 

flag word 




Figure 33-10. 1ED Main Loop (Continued) 
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Figure 33-10. 1ED Main Loop (Continued) 
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FILE ROUTING AND QUEUE MANAGEMENT 



34 



INTRODUCTION 

» queued file is any file residing in , qu.u.. «u.u.d file. 

nave file types !NFT (input), ROFT ro I out), PRFT Cp in t>, 

PHFT (punch), TEFT ( t i med/event ro lloul), ° J 

file types (S1FT, S 2 FT, and S3FT . When the fil 

queue, it is not at a control point; that is, 

number field in the FNT is zero. 

Hie routing i s the proc es s by whi ch a file ^entered intc^a^ 

and punch files) queues; the file types ROFT and TEr 
with by job scheduling concepts. 

The special file types CS1FT, S2FT, and S3FT) are provided to 
of each type being noted on an exception . basis . 



QUEUED FILE CONTROLS 

The following paragraphs describe validation 
the use of queued files. 



requirements for 



DISPOSED OUTPUT VALIDATION 

Output file validation controls the total number 



f files that 



U an P b ueuedu put queue by a 30b during its execution, 
he intent of this control is to limit the total number of 
u? D ut queue FNT entries consumed by the job's output files, 
utput fites nclude all files queued to the print or punch 



c 

T 

o 

Outp 

queue by DSP, LFM, OUT, and CIO. 



eter OF defines the job output file limit for 




Limit has been exceeded. The job is then aborted. 
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A six-bit field is defined in the control point area, bits 23 
through 18 of word ACLW, to maintain the job's current output 
file limit. If the field is initially set to 77B, the user's 
job output files are not limited. Otherwise, the value is 
decremented as print and punch files are queued until the count 
reaches zero for the user's job. 



DEFERRED BATCH VALIDATION 

Deferred batch validation controls the total number of deferred 
batch jobs the user is allowed to have in the system 
concurrently. The intent of this control is to prevent a user 
from inadvertently or intentionally flooding the system with 
deferred batch jobs. Deferred batch jobs are jobs the user has 
initiated with the SUBMIT, LDI, or ROUTE control statements, or 
with the SUBMIT or ROUTE macros. 

The MODVAL parameter DB defines the deferred batch limit for 
each user and is maintained in the system validation file. 
During execution of the user's job, the limit resides in a 
three-bit field in the control point area. This field is read 
by QFM and DSP to determine the user's deferred batch limit 
before a file is placed into the input queue. If the user has 
system origin privileges (determined by COMPCUA) or is validated 
for an unlimited number of deferred batch jobs (determined by 
COMPCVI) the file is entered into the input queue. 

Otherwise, the control point areas and FNTs are scanned for jobs 
belonging to the user. Only batch (BCOT) and remote batch (EIOT) 
origin jobs belonging to the user are counted. These jobs 
include all jobs initiated by BATCHIO, RBF, or EI200 and by the 
user with the SUBMIT, ROUTE, or LDI control statements and any 
queued file generated by these jobs. The job doing the 
submitting is not counted toward the deferred batch limit. The 
system determines if a job belongs to a user by comparing the 
user index hash of the job name with the user index hash 
generated by the user index found in the control point area. If 
the total number of jobs belonging to the user is less than the 
deferred batch limit, the file is entered into the input queue. 
If the deferred batch limit is exceeded, a dayf i le message is 
issued indicating the user has exceeded his deferred batch limit 
and the job is aborted. 

SECURITY COUNT VALIDATION 

Security count validation controls the number of security 
violations a user may attempt before the user is denied access 
to the system. The intent of this control is to prevent a user 
from using the SUBMIT and ROUTE macros to determine valid user 
number/password combinations. 
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cr *.«+•<- tho epcurity count for each user. 
The MODVAL parameter SC "* 8 ^J^™ P ld 1n the system 
This count is maintained in a si x b detected, OAV is 

validation file- When a breach of security i* , 

called to decrement the violator's »" rl J u u ^ e e 
validation file. When a user's security count has bee n 
decremented to zero, the user is not a ^owed access ^ to the 
system. The following message is issued to the use s dayfile 
and the job is aborted or logged off. 

ILLEGAL USER ACCESS - CONTACT SITE OPR. 

The security count must be reset by MODVAL before the user is 
permitted access to the system. 

Currently, security violations are detected by CPM when an 

nv Ud secondary user statement is entered or y M DSP 
when a job submits a job file with an invalid P r mary user 
statement. In addition to decrementing the us er s secur ity 
rn.m* the user's iob is aborted or logged off. This allows mm, 
1L™ and CPM to check the user's security count when he attempts 
to regain access to the system. 

RBF and EI200 do not decrement the security count of the . us * r 
number that is logged in to the remote terminal w en an invalid 
primary user statement is encountered in a job me. 

A six-bit field for the security count is maintained in the 
sy em validation file for each user If this i< .Id is set to 
77B, the user's security count is unlimited. Otherwise, OAV 
decrements the field by one for each security violation 
attempted until the count becomes zero. 

QUEUED FILE SYSTEM SECTOR 

All information describing the properties of a queued file ]s 

t he file's sysUm sectpr. This allows the descriptive 
information to be recovered over any type of deadstart and it 
allows the limited space available in the FNT/FST entry for the 
queued file to be used efficiently. 



The 

The 

type 

sect 

t hre 

f i le 

outp 

and 

i s c 

f i le 

the 



queue 
f i rst 
s. I 
or by 
e CM 
s, th 
ut fi 
dayf i 
ommon 
rout 
queue 



d fi 

10B 

n mo 

com 

word 

i s a 

les, 

le r 

for 

i ng 

d fi 



le syst 
CM wor 
st case 
mon dec 
s are u 
rea is 

this a 

andom a 

both i 

and que 

le syst 



em s 
ds a 
s, t 

k CO 
sed 
set 
rea 
ddre 
nput 
ue r 
em s 



ector 
re us 
hese 
MPWSS 
for f 
with 
conta 
ss . 

and 
ecove 
ector 



con 
ed f 
fiel 

(wr 
i le 
j ob 
i ns 
The 
outp 
ry i 

i s 



sists of four general areas, 
or data common to all file 
ds are entered into the system 
ite system sector). The next 
dependent data. For input 
statement information. For . 
repeat count, line/card limit, 
third area of the system sector 
ut files. This area contains 
nformation. The final area in 
reserved for installation usage 



The definition of the individual fields in the queued file 
Intern sector is found in common deckCOMSSSE System ector 
Equivalences). The system sector is illustrated in section Z. 
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INPUT FILE EQUIVALENCES 

The following input file equivalences are defined for input file 
system sectors (location relative to BFMS). 



Relative Location 



Symbol 



50 


JISS 


50-51 


JSSS 


53 


JTSS 


54 


JFSS 


55 


JCSS 


56 


JESS 


57-60 


CRSS 


62-65 


TNSS 



Def i ni t ion 

Job input data 
Job sequence number 
Job step time limit 
Job flags: 

1/EI job, 
Job card CM 
Job and ECS 
(not used) 
Number of cards 
Terminal name 



10/0, 1/KEYPM 
field length 
field length 



read 



OUTPUT FILE EQUIVALENCES 

The following output file equivalences are defined for output 
file system sec-tors. 



Relative Location Symbol 

51 PFSS 

52-53 RASS 

54 SCSS 

55 LCSS 
62 RCSS 
63-64 RTSS 
65 RBSS 



Def i ni t ion 

Reserved for previous 
system compatibility 
Dayfile random address 
Spacing code for 580-PFC 
Line/card limit index 
Repeat count 
Random index 
Requeue buffer 
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COMMON INPUT/OUTPUT FILE EQUIVALENCES 

The following equivalences are common 
system sectors- 
Symbol 



\\ M \. U W 1 V W .■ w w — - - - _ 

67 


OTSS 


70 


PRSS 


71 


MISS 


72-73 


FLSS 


74 


ICSS 


75 


ECSS 


76 


FCSS 


77 


DVSS 


100 


DCSS 


101-105 


DASS 


106-111 


FDSS 


112 


ODSS 


113-114 


DISS 


120-124 


FSSS 


125-130 


FMSS 


131 


OOSS 


132-136 


ACSS 


137-143 


CDSS 


144-150 


JNSS 


151-155 


OHSS 


156-162 


DHSS 


163-167 


FRSS 



170 
315 

315 



VASS 
EISS 

UBSS 



to input and output file 



Def i ni t ion 

File origin type 

Fi le priority 

MMF machine ID 

File length in sectors/10B 

Internal characteristics 

External characteristics 

Forms code 

Devi ce code 

NOS/BE device code 

User number and index of 
destination 

Family name of destination 
Fami ly ordina I of 

destination (not used) 
Destination terminal ID 
FST entry for queue 

protected f i les 
Family name of creator 
Family ordinal of creator 
(not used) 

User number of creator 
Recovery flag; queued file 

creation date and time 
job card job name 
Origination host name 
Destination host name 
Fi le routing control 
includes data in user 
block and file placed in 
queue flags 
User validation block 
End of system initialized 

data 
User data block (10 CM 
words) 



NOTE 



If the same information is contained in both the 
FNT/FST and system sector (for example, 30b origin 
or forms code), it must agree in order for queue 
* *« ,.. rt rk nronerlv. It is the 



management to work properly 
responsibility of the routine that 
into the queue to properly imtiali 
the system sector- 



is the 

put the file 
ze fields i n 
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QUEUED FILE FNT/FST 

To reduce the amount of overhead required to read the system 
sector of output queue files to obtain routing information, 
abbreviated forms of the forms code, device code, and external 
characteristics are kept in the queued file FNT/FST entry. This 
information is usually sufficient to allow the system to 
determine if an output file should be selected for processing 
without having to read its system sector. The format is as 
follows. 



59 53 47 



35 32 



17 



11 



file name 


origin 
type 


PRFT 

or 
PHFT 





d 


X 


eq. no. 


first track 


f 


tid 


priority 



System sector information bit: 

No queue information present 

1 Queue information present 



d 

x 

f 

tid 



Device selection code 
External characteristics code 
Forms code 
Terminal identification 



The values for the d, x, and f fields are specified in common 
deck COMSJIO. 



DEFERRED ROUTE 

Bit 5 of the FNT is used to indicate that the system sector 
contains queued file information. The concept of a deferred 
route involves the use of this bit. A deferred routed file is a 
queue type file assigned to a control point with bit 5 set; that 
is, the system sector has already been correctly formatted for a 
queue type file that has not yet been released to its queue. 

A file becomes a deferred file in one of the following manners. 

• A ROUTE/DSP call was made to do a deferred route on a file 

• A queued file with a formatted system sector was extracted 
from its queue and assigned to a control point (for example,) 
QAC attaches an output file to BATCHIO or RBF for processing 

• An input file is created with system sector information 
when reading card decks by QAP, 1LS, or VEJ . 
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FILE ROUTING CONCEPTS 

.. j:*4:« Pa rvt rnntina oDtions and how they 
This section discusses different rouxiny u^i. 

are related to each other. 



TERMINAL ADDRESSING 
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U.y, 
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t e rmi na 
at i on f 

termi n 

origin 
T) file 

a re ze 
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I. T 
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remo 
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i cu La r I 
he termi 

name (F 

(DISS) . 

of the 
e dest i n 
The term 
h the eq 
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and TID 
vely of 
routed f 



i na L 
i ne p 
na L a 
DSS); 
The 
fi Le. 
at i on 
i na L 
ui pme 
or i g 
a re 
a rem 
or di 



address used by 
ri nter, card 
ddress consists 

dest i nat i on 
se i terns are 
For batch and 

f ami Ly name and 
ID (DISS) is set 
nt that is to be 
in (EIOT) files, 
the f ami Ly name, 
ote batch 
spos i t i on . 



The default terminal address for any job s er ed the 
time the job's input file is created. VEJ, « , 1LS, DSP, 
QFM set this default information into the job 's input fi le 
system sector. When output is disposed by the job, the 
disposing routine through common deck COHPUSS ^P*'*!. »"»"" 
sector) moves the default terminal information from th. input 
file system sector to the output file system sector. In this 
manner'all output is routed back to the terminal that created 
the job' s input file. 

When processing EIOT queued files, the M™ 1 "! ""?" ° f "^ 
FNT is insufficient for proper routing » inc » ^""J* 1 ^, syst em 
family/user information is also required. Therefore, the system 
sector of a remote batch terminal (EIOT) queued file is always 
read in terminal address processing. 

ALTERNATE ROUTINGS 

There are times when a file is to be routed to a termi na I other 
than the one specified by the default terminal address. _ This 




queuedfile. 

The terminal address of a queued file may also be changed by the 
ALTER function of QAC while the file is in the queue. 

Once the. file has been entered into the queue the t.r.in.l^ 
information is used by QAC and 1L5 Tor sej.ei.tiu 
file for the specified terminal. 
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SPECIAL FILE ID CODES 



Fi Le 
def i n 
Two s 
queue 
of ze 
mac ro 
a Lso 
throu 
when 
dropp 
has a 
j ob c 



ID code 
ed i n c 
peci al 

file m 
ro has 
) to di 
zero) . 
gh 54) 
queuing 
ed rath 
n SOID, 
omplet i 



s 70 
ommo 
ID c 
anag 
been 
f f er 

LFM 
and 

the 
er t 

all 
on. 



-77 
n de 
odes 
emen 

ass 
ent i 

set 
COMP 

fit 
han 

non 



(oct 
ck C 
ZRI 
t. 

i gne 
ate 
s ZR 
USS 
e. 

queu 
def e 



at) are reserved for system usage as 
OMSSSJ (special system job equivalences). 
D (71) and SOID (77) are related to 
ZRID is used to indicate that an ID code 
d to a file by LFM (SETID statement or 
it from the absence of an ID (which is 
ID into the FST ID field (bits 59 
converts ZRID to its proper zero value 
SOID indicates that the file should be 
ed at job completion. If the input file 
rred, zero ID output files are dropped at 



NOTE 



The SETID processing in LFM changes the ID 
field in the FST only. COMPUSS moves the 
ID into the systems sector when the file 
is queued. The DSD console command ENID 
performs a similar operation for BCOT and 
SYOT output files. The ID so specified is 
lost if the queued files are recovered over 
a level deadstart. 



DEVICE SPECIFICATION 

The terminal address defines a set of printers and punches for 
output file disposal. Additional routing information may be 
specified to further define the type of equipment that should 
process the output file. This routing information consists of 
device selection code, external characteristics, and forms code. 

COMPUSS sets default values for device code (DVSS), external 
characteristics (ECSS), and forms code (FCSS) into the system 
sector and FNT/FST entry. DSP is the only system program that 
alters all these values. Once a file has been queued, the ALTER 
function of QAC can be used to change the forms code. The device 
selection code and external characteristics cannot be changed 
once the file has been queued. 

This information is used by QAC to select a queued file for 
disposal. Device selection is used to specify a particular type 
of device that is to process the file; for example, a 580-12 (LR) 
printer. The external characteristics specify what format the 
data is in. This information is used to specify the print train 
for line printers and the punch format for card punches. For 
example, for print files, this could be 64 character set BCD 
(B6). For punch files, it could be 80 column binary (80 COL). 
The external characteristics is dependent upon the file type. The 
device selection codes and external characteristics are defined 
in common deck CQMSJIO. 
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FORMS CODE 

f »r.s code consists of two alphanu.er jc character s that c an be 

assigned to an output filt. An °^} a latching forms code. The 

?-rcSdr:r:^ y osp ^ e :;n e b r h Lt :r s ,.c ; - r - : - 

COMPVFC (verify forms code) is used to validate the forms code 
when it is associated with a file. 

. * • i i-ii-r/ecT ««+-r.w nniv "^ hits are available for 
In the queued file FNT/FST entry, only 5 bits are 

the F field (forms code). Only the forms codes A V **' *^' AD ' 
AE AF and null can be represented by this restricted field. A 
?o'rms code value of EXIN (7) in the FST entry indicates hat the 
system sector must be read to determine what forms code is 
required to properly dispose the queued file. 

A special output file is a file that has been routed to a 

::^'"j.5i::i , s:n.:::ss;.:-u- b :.'r.3. d ;:;'sr,s:. 



QUEUE MANAGEMENT EQUIVALENCES 



defines equivalences for programs doing 
defined in COMSJIO are the 

the FST and indicates that 



Common deck COMSJIO 

queue management. The values 

foLLowinq (these codes are used in 

the information is too detaUed for the FST and the system 

sector should be used). 



Va lue 

7 

6 

67 



Symbol 

EXIN 
SPEQ 
SPDV 



Def i ni t i on 

Extended information flag 
Special device 
Special equipment 



Print file external characteristics (these codes are used in 
both the FST and system sector) are as follows. 



Va lue 


1 
2 



Symbo I 

DFEX 
RREX 
A4EX 

B4EX 



4 


B6EX 


B6 


5 


A6EX 


A6 


6 


A9EX 


A9 



Def i ni t i on 

Default printer 

Reserved 

A4 - ASCII graphic 48 character set 
(not supported) 
BCD graphic 48 character set 
(not supported) 

CDC graphic 63/64 character set 
ASCII graphic 63/64 character set 
ASCII graphic 95 character set 



B4 - 
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DFFR 


1 


PBFR 


2 


P8FR 


3 


RIFR 


4 


PHFR 


5 


P9FR 


6 


ASFR 



Punch queue external characteristics (these codes are used in 
both the FST and system sector) are the following. 

Value Symbol Definition 

Default punch 

SB (system binary) 

80C0L (80 column binary) 

Reserved 

026 

029 

ASCII 

Internal characteristics (these codes appear only in the system 
sector) include the following. 

Value Symbol Def ini t i on 

DCIC Display code 

1 ASIC ASCII 

2 BNIC Binary 

3 RRIC Reserved 

NOS device codes (these codes are used only in the queued file 
FST) are the following. 

Value Symbol Def ini ti on 






PRDV 


UP (any printer) 


1 


P1DV 


Reserved 


2 


P2DV 


Reserved 


3 


LRDV 


LR (580-12) 


4 


LSDV 


LS (580-16) 


5 


LTDV 


LT (580-20) 





SBDV 


SB (system binary) 





P8DV 


P8 (80 column binary) 





PBDV 


PB (system binary) 





PUDV 


PH (punch coded) 



The following device codes are reserved for future enhancements 

Value Symbol Def ini t i on 

(microfilm printer) 
(microfilm printer) 
(plotter) 

(hard copy printer) 
(hard copy plotter) 
Reserved for installations 
Reserved for installations 






FRDV 


FR 


1 


FLDV 


FR 


2 


PTDV 


PT 


3 


HRDV 


HR 


4 


HLDV 


HL 


5 


I1DV 


Re 


6 


I2DV 


Re 
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NOS/BE compatible device codes (these codes are only used 
systems sector) include the following. 



i n the 



Va lue 

10 
20 
22 
24 
26 
30 
40 
41 
42 
43 
44 
45 



Symbol 

PUDC 
FRDC 
FLDC 
HROC 
HLDC 
PTDC 
PRDC 
P1DC 
P2DC 
LRDC 
LSDC 
LTDC 



Def i ni t i on 

PU (punch) 

FR (microfilm printer) 

FL (microfilm plotter) 

HR (hard copy printer) 

HL (hard copy plotter) 

PT (plotter) 

LP (any printer) 

Reserved 

Reserved 

LR (580-12 printer) 

LS (580-16 printer) 

LT (580-20 printer) 



CREATING A QUEUED FILE 
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der two conditions- The 
nput file by reading a job 

BATCHI0, RBF, or EI200. In 
the input file system sector 
e file processor based on 
ote batch terminal reading 
he creation of a queued file 
ed at a user control point, 
e the default terminal 
ector to the system sector 
ation is encountered as part 
close/unload and 
) operations. 



QUEUE MANAGEMENT ROUTINES 



Many system routines are involved in file routing and queue 
management. Utilities which manipulate active and inactive 
queues (QREC, QFSP, QDUMP, QL0AD, and QM0VE) and their helper 
routine (QFM) are described in the N0S System Maintenance 
Reference Manual. The remainder of this section details the 



PP 



file routing and queue management functions 
QAC 



key 
C0MPUSS, DSP, and 



C0MPUSS 



The key routine in creating output queue files is common 
C0MPUSS (update system sector for disposable files). This 



deck 
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common deck is used by all PP routines that place files into the 
output queues. Its purpose is to generate and write the system 
sector for a queue file. 

COMPUSS consists of two main subroutines: USS (update system 
sector) and WQS (write queued file system sector). 



USS - UPDATE SYSTEM SECTOR 

USS is used to update the information in a file's system sector 
prior to entering the file in the queue. The preserved file bit 
is set if I/O queue protect is active. 

COMPUSS requires the presence of common decks COMPRSS, COMPSEI, 
COMPWSS, CQMPSSE, COMSCPS, COMSJIO, and COMSSSE. 

Since mass storage error processing is selected by COMPUSS, the 
error processor for COMPRSS should be defined. 

If USS$ is defined, COMPUSS allows the calling program to modify 
the queued file system sector before it is written back to mass 
storage. The calling program should make a call to USS to set 
up the default system sector in BFMS. The desired fields are 
then set and a second call is made to WQS to write the system 
sector and preserve the file. If USS$ is not defined, the 
queued file system sector is built and written to mass storage 
and the file is preserved with one call to USS. 

The system sector fields listed below are set by COMPUSS when 
one of the following files are processed. 

• Any local (LOFT) file 

• Print (PRFT) files with system sector information bit 
not set 

• Punch (PHFT) files with system sector information bit 

not set 

• Input (INFT) files with system sector information bit 
not set 

The fields updated are the following. 



Field 
(JNSS - JNSS+4) 
(ACSS - ACSS+4) 

(OHSS - OHSS+4) 

(FMSS - FMSS+4) 
(OOSS) 



Desc ri pt ion 

Job card name from job file 

Origination user number from job 
f i le 

Origination host name from job file 
(for future use) 

Origination family name from job file 

Origination family ordinal from job 
file (for future use) 
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Field 
(DASS - DASS+4) 
(DHSS - DHSS+4) 

CFDSS - FDSS+4) 
(OOSS) 

(DVSS) 

(DISS - DISS+1) 

(RCSS) 

(RTSS - RTSS+1) 

(RBSS - RBSS+1 ) 
(LCSS) 

(FCSS) 
(ICSS) 

(ECSS) 

(SCSS) 

(DCSS) 

(COSS - CDSS+4) 

(MISS) 



Description 

Destination user number from job file 

Destination host name from job file 
(for future use) 

Destination family name 

Destination family ordinal from job 
f i le (for future use) 

Destination device identification 
f rom job input file 

Destination terminal identification 
from job file 

0, repeat count (output files only) 

0, restart random address (for output 
f i les only) 

0, restart buffer (output files only) 

Lines or cards limit (output files 
only) 

0, forms code (output file only) 

0, internal characteristics (output 
f i les only) 

0, external characteristics (output 
f i les only) 

0, spacing code (print files only) 
N0S/BE device code 
Creation date 
Machine ID 



The following fields are set whenever COMPUSS is called to write 
the queued file system sector. 



Field 
(0TSS) 
(FLSS) 
(FASS) 



Desc ri pt ion 

Origin type 

File length in sectors/10B 

FST address 
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If USS$ is defined, the calling program must set: 
Field Desc ri pt ion 

FNT entry 
FST entry 
Priority 



(FNSS - FNSS+4) 
(FSSS - FSSS+4) 
(PRSS) 



The main subroutine of COMPUSS is USS and is flowcharted in 
f i gure 34-1 . 
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initial 
COMPUSS 



read system 

sector of file 

to queue 



read system 

sector of 

input file 





Save: 

• FNT address 

■ origin type 

■ queue type 

■ input file ID 



process 

deferred 

routed file 



clear 
system 
sector 
buffer 



-►UJSS19) 



Set: 

• FNT/FST 

Clear: 

• input file ID 

• control point 
assignment 



Figure 34-1. COMPUSS - Subroutine USS 
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- clear file 
dependent 
data in 
system sector 



set destination 
routing address 
in system 
sector 



i 



set information in 
system sector: 

creation date 



machine ID 

creation family 
name 

creation user 
number 





clear NOS/BE 
device code (OCSS) 

and set 
disposition code 

to IN 



1 



set external charac- 
teristics, print file 
limit, NOS/BE 
device code, disposi 
tion code 



clear internal 
characteristics, 
set external 
characteristics, 
set punch file 
limit, set NOS/BE 
device code, set 
disposition code 




set random 

address of 

dayfile in 

RASS - RASS+1 




USS19W 



Figure 34-1. COMPUSS - Subroutine USS (Continued) 
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set batch ID 
in system 
sector TID 
DISS DISS+1 




set FST TID 
field from 
DISS - DISS+1 



yes 




yes 



write local 
FNT/FST into 
FNSS and FSSS 



set priority 
into PRSS 



set preserve 
flag 



WQS 



write queued 

file system 

section 



(return to A 
caller J 



Figure 34-1. COMPUSS - Subroutine USS (Continued) 
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The manner in which USS sets up the system sector buffer depends 
on the status of bit 5 in the FNT of the file that is being 
queued. If bit 5 is set, the system sector has been formatted 
previously- The system sector is read and if the read is 
successful, the dayfile random address (if one exists for print 
files) is entered into RASS through RASS+1 . The file ID is 
entered into the system sector for non-EIOT jobs as the terminal 
ID (DISS through DISS+1) and this value (terminal ID) is entered 
into the FST for all output files. The system sector is then 
written according to the USS$ setting (as described below). The 
FNT/FST entries in use by the caller are then replaced with 
those from the system sector (FNSS/FSSS). 

If the system sector had not previously been written (bit 5 is 
not set in the FNT entry) or was unable to be read successfully, 
a default system sector is built as follows. If the job is not 
a time-sharing origin (TXOT) job, then there may be routing 
information in the input file system sector that needs to be 
passed on to the output file system sector. An attempt is made 
to read the input file system sector and if successful, the 
destination routing information (FDSS, DASS, DISS) contained 
there is used for the output file. If no data existed in the 
input file system sector (bit 5 of the FNT was not set) or the 
sector was not able to be read, t he *dest i nat i on family (FDSS), 
destination user number (DASS), and terminal ID (DISS) are 
entered into the system sector dependent upon the origin type of 
the file being queued and the caller's origin type. 

The terminal ID is either the file ID of the input file or the 
user index of the destination family/user number. The creation 
date is entered into CDSS from PDTL, the machine ID set into 
MISS, and the creation family name (FMSS) and user number (ACSS) 
are entered from either the control point area (UIDW) or SSJ= 
call block (UIDS). Defaults are set for the disposition code 
(DCSS), spacing code (SCSS), internal and external 
characteristics (ICSS/ECSS), line/card limits (LCSS, as obtained 
from the control point area or SSJ= call block), and device code 
DVSS). Finally, the random address of the dayfile for print 
files (if one exists) is entered into RASS through RASS+1. The 
file ID is then set into the system sector for non-EIOT jobs as 
the terminal ID (DISS through DISS+1) and into the FST. The 
system sector may then be written (as described below) and the 
FNT/FST entry replaced with that from the system sector in the 
calling program. 

If symbol USS$ is not defined in the calling program, the FNT/FST 
entries are reentered into the system sector (FNSS/FSSS), and 
into central memory and the priority set into the system sector 
(PRSS). At this point all places that contain the FNT/FST entries 
(system sector, FNT/FST in central memory, and in the caller's 
direct cells) will have the same values. The system sector is 
then written and the file preserved by a call to subroutine WQS. 
To queue the file in this case, the caller only needs to write 
the FNT/FST entry returned by the USS call. If USS$ is defined, 
the newly built (or rebuilt) system sector is left in the buffer 
for use by the caller. 
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DSP and 1CJ are examples of the usage of COMPUSS with USS$ 
defined and not defined respectively. DSP builds the system 
sector by a USS call but then adds disposition charactenstus 
to the sector before writing it using a 



WQS call. 1 C J , on the 



other hand, relies entirely on default information and 
subsequently lets the USS call build and write the syst 



em sector. 



WQS - WRITE QUEUED FILE SYSTEM SECTOR 

s it writes it. 



If the file is 




writes the sector: equipment (EQSS); first track (FTSS); and 
packed date/time (DTSS). 

Upon return from WSS, if the file is to be preserved, an STBM 
monitor function is issued to set the preserved file bit and 
revest a checkpoint of the device. This request is ignored by 
CPUMTR 



if QPROTECT is not enabled 



Callers of COMPUSS 



COMPUSS is 



used by all routines that enter files into the 



input/output queues (CIO, DSP, LFM, OUT Q M d • Any 
routines that are locally introduced must follow COMPUSS 
conventions if they wish to queue input/output files in order t 
guarantee correct processing of queued files. 



DSP - DISPOSE FILE TO I/O QUEUE 



DSP is ca I led 



DSP places a file into the input or output queue, 
by QAP. RBF, the queue utilities (QDUMP, QLOAD, and QMOVE), and 
through use of the ROUTE macro. The SSJ= caller may provide a 
system sector to be used in the disposal; this technique is 
typically used by the queue utilities. 

The main routine of DSP is flowcharted in figure 34-2. For a 
compile Ascription of the DSP call and parameter block refer 
to volume 2 of the NOS Reference Manual. 
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PSR 



PRESET 



FFQ 



find file 
for queuing 



I 



ODC 



determine 
disposition code/ 





SQS 



set queued file 
system sector 



SDC 



set disposition 
code 




set file type 
to LOFT 




Figure 34-2- DSP Main Routines 
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UDSP3 J 



SFO 



set file 
destination 



I 



SPR 



set 
priority 



set FNT/FST 
into system 
sector FNSS 
and FSSS 



check binary 

sequence 

error 





read FNT/FST 
set queue type 
set do not 
preserve 



i 



clear control 

point 

assignment 





set do not 
preserve flag 



J 



WQS 



write queued 

file system 

sector 



I 




write new 
FNT/FST 




>2 

no 




*1 Flag bit not set if immediate route 
*2 Flag bit 5 set if returning name. 



Figure 34-2. DSP Main Routine (Continued) 
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M3SPX J 

read first 
word of call 
block 




set function com- 
plete; set error 
code (if any) 
rewrite first 
word 




*1 Entry from Error Processor. 

Figure 34-2. DSP Main Routine (Continued) 
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default values in the ^^d^ed to be an acceptable NOSorign 
code is forced, it s valida ted t _ ^ forcing f 

tt.'ofti'n Tpe 1s f ont y (B V alid for syste* origin callers and is 
primarily used for network startup. 

creates a file to be queued. 

Subroutine DDC '^Ur.ine disposition eode) is called to set up 

the disposition code. The di sposi t i on c code bit ls 

parameter block, but is only « ' * ^ d p ^ ^ 1? npt 

also set in the DSP flags. I • ' »P ° eued fU , without 

set and file is not a queued fi e or is q Lt dispoS ition 

the system sector i nf ormati on bi t »•*, * h ^ special file names 

code is established "/ •cannnng th.. I it °' P C0UTPUT = LP , 

for the code associated with ^V^ 1 aL T £e disposition code is ^ 

PUNCH = PU, PUNCHB = PB, and " ' P °; ' , ™ J es for it CTODC table) 

then validated and an index ' L 7 P \ ocal file not having 

iS SaVed L f name U wiU in'effec do nothing; the file remains at 
a special -name wii-i »n ei •<=»-«. 

the control point. 

Subroutine VuL is then called to validate user limits (deferred 

batch and output file limits). 

... a- + n rptrieve the system sector into BFMS. 
Subroutine SQS is c.l l.d to r.t ieve the y ^ ^ c s . 

This is accomplished by a call to u h t wr iting 

DSP has COMPUSS assembled with , USSS defined, 

the system sector during the USS can. 

The USS either returns the systen, sector from the queued file or 

builds a defaulted system sector. 

subroutine SDC is then called t° -t the disposition^ode^n^e 
system sector. This involv.s ..ttina th? F ST y 1nfor mation 
words ECSS, KSS, and » s " " c "" data 1a obtained from 
I^e tabiroVde ::irrtln:°infor:;tion CT00O whic, .contains 

the NOS device mnemonic, queue type, ^^irrll 
NOS/BE system sector device mnemonic. 
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If the routing is to the input queue, subroutine VIF is called. 
If there is no data in the system sector, then the routing is 
the first attempt to put a file (job) into the input queue. The 
first sector must not be empty as this sector should contain the 
control statements for the job. These control statements are 
validated as job/user statements by a call to OVJ with 
appropriate error processing for job and user control statement 
errors. 

If the routing is to the output queue, subroutine SOD is called. 
A repeat count, if specified, is entered into system sector word 
RCSS, internal and external characteristics (ICSS, ECSS) are 
entered as specified or defaulted, and forms code CFCSS) and 
spacing code CSCSS) are entered. The flag bits are used to 
determine if these values are specified. 

Subroutine SFD is then called to set the file destination and 
special ID in the TID field of the FST and in DISS through DISS+1 
of the system sector. 

Subroutine SPR is called to set the file's priority in the FST 
and system sector word PRSS from the job control block for the 
queue and origin type. The priority is set to ERPS if a job 
statement error is detected through JCSS. For output files, DSP 
rounds the specified priority to fit the allowable priority range 
for the particular origin, type. 

The file's FNT/FST entries, as updated by all these subroutine 
calls, are then updated in the system sector words FNSS and FSSS. 

On input files from BATCHIO (QAP), if an i mmedi ate route is being 
done (flag bit not set), subroutine BSE is called to set the 
FST for binary sequence error processing if it had been detected. 

Subroutine WQS in COMPUSS is called with file preservation 
specified unless input flags were set to not preserve the input 
f i le. 

DSP completes its processing by writing the FNT/FST for the file, 
returning information to the call block, and drops the PP. It is 
at this time when the FNT/FST is rewritten that the file is 
either queued (immediate route) or left assigned to the control 
point (deferred route). If an output file is being disposed, the 
number of disposed output files are decremented through a UDAM 
moni tor f unct ion . 

Overlay 3DA is called to process error conditions detected by DSP 
processi ng . 

The error messages issued by 3DA are listed in volume 1 of the 
NOS Reference Manual. If in the call block, bit 12 of the flags 
is set, the error code is returned and no message issued. 
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QAC - QUEUE ACCESS 



be used to 



Once a file has been entered into the , qu.u.j Jj «*J t "^ routing 
attach the file to .control pcMnt a t ^;. on about th , 

}■ ^"niris^se o e B ;;CHI0 O tYattach output files; f EI200 to 
oJip'lob., RBF to attach, alter and status 30b nd^fUe^^^ 
FNTLIST to status queues; and QALTER to status 
CAC is called by 110 and RBF to identify files for disposal on 

unit a {::°^ :r:s\: nt ..i: tic\:i:v. e ^ m catu .;.\.u- °^> - 



may 
the 

The 
a re 



caUer has a priority greater than MXPS. 

format of the SAC call, its parameter block and error codes 

as follows. 



59 
1 — 



41 



17 



QAC 



1 

J2L 







addr 



r 
addr 



Autorecall bit (optional) 
FWA of parameter block 
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The parameter block format is as follows. 



59 53 47 



35 32 29 23 17 11 



3 



addr+O 



+ 1 



+ 2 



+3 



+ 4 



+ 5 



+ 6 



file name or job name 


err 


queue 


fc c 


alter 


forms 


ec 


ic 


dev 


re 


fwa 


reserved 


FNT address 


ot 


new tid 


tid 


priority 


day file 


flags 


exent 


len 


res 


incnt 


prcnt 


phent 


reserved 


sc 


line or card limit 




link 



err Error code returned (complete description follows), 
queue Queue type: 

Queue Desc ri pt ion 



1 
2 
4 
8 
16 

f c Funct ion code : 

Code 


1 
2 
3 



Input file 

Output file 

Punch file 

Speci a I output 

Executing job (at control point 

or in rollout queue) 



Description 

ALTER function 
GET f unct i on 
PEEK function 
COUNT function 



Completion bit. Must be on call; set to 1 upon 
comp let ion. 
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alter ALTER flags: 



form 



ec 



1 c 



Forms 
PEEK, 
ALTER 



Bit 

56 

55 

54 

53 
52 

51 

50 

49 

48 



Desc ri pt i on 

FNT flag (check specified FNT 

only) . 

Ignore upper six bits oT 
di spos it ion field 
Change spacing code (output 

files only) 
Abort job or evi ct file 
Change repeat count (output 

files only) 
Change forms code (output files 

only) . 

Change priority (output tiles 

on ly) 
Change destination TID to new 

TID 
Send to central site 



code. IF bit 
and COUNT use 
changes forms 



51 of flag field is set, GET, 
forms code as search criteria, 
code of output files to the 
specified forms code. If bit 51 is not set, all 
functions ignore the forms code field. 

External characteristics 

(For detailed description, refer to DSP MariiiaM 

documentation in volume 2 of NOS Reference Manual) 

Internal characteristics 

(For detailed description, refer to DSP „ n „_ n 

documentation in volume 2 of NOS Reference Manual) 



dev 



Device code : 




Mnemoni c 


Code 


PU 
FR 


10 
20 


FL 


22 


HR 


24 


PL 
PT 
PR 
LR 


26 
30 
40 
43 


LS 


44 


LT 


45 


«• «» 


46-67 


_ _ 


70-77 



Description 

Punch 

Microfilm printer 

(for future) 

Microfilm plotter 

(for future) 

Hard copy printer 

(for future) 

Hard copy plotter 

Plot 

Any printer 

Select 580-12 

printer 

Select 580-16 

printer 

Select 580-20 

printer 

Reserved for CDC 

Reserved for 

i nstal lat ions 
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re Repeat count (maximum value is 37B) . 

fwa FWA of reply buffer or FWA of dayfile message. 

ot Origin type (0 = system, 1 = batch, 
2 = remote batch) - 

tid Terminal ID. If the upper six bits are equal to 77B, 
the lower bits contain the complement of the CM 
address of a two-word family name/user number area 
(each in upper 42 bits of word). If the upper six 
bits are not equal to 77B, the lower eighteen bits 
contain the TID. 

dayfile Random address of dayfile left justified, 
f lags Flag bi ts: 

Bi t Desc ri pt ion 

13 Return extended information 

14 Inhibit duplicate file search 
15-16 Reserved 

17 Dayfile present (output files 

on ly) 
exent Executing job count. 

len Parameter block length. 

res Reserved. 

incnt Input file count. 

prcnt Print file count. 

phent Punch file count. 

sc Spacing code for output files. 

link Link address to next QAC call block. If 0, no 
address is specified. 
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The following error codes are returned to the 
when the specified situation occurs. 



QAC call block 



Error 
Code 

1 



Message 
INVALID QUEUE TYPE 



NO FILE FOUND 



ILLEGAL PRIORITY 
SPECIFICATION. 



Description 

QAC was called with no 
queue type specified, 
function 1 <GET queued 
file) was called with 
than one queue type 
specified or with input 
and/or executing queue 
flags set. 

QAC did not find a file 
that met the selection 
criteria. 

The priority field in the 
call block is 7777B. This 
i s illegal for function U 

(ALTER) and function 2 
(PEEK) . 



CM ADDRESS 
RANGE. 



OUT OF RANGE 



Reserved . 

May occur in one of the 
following conditions. 

t The address of the 

family name/user number 
block passed in the TID 
field is out of range 

• The FWA of the message 
buffer for function 
(ALTER) is out of range 

, The PEEK reply buffer 
address is out of range 



6 

7 

10 

11 



TOO MANY FILE 
TYPES SPECIFIED. 



Reserved . 

Reserved. 

Reserved. 

Function 2 (PEEK) must 
not be called wi th more 
than one f i le type 
speci f i ed in the call 
b lock . 
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Error 

Code Message 

12 DUPLICATE FILE FOUND. 



13 



COUNT OF ZERO INVALID 



14 
15 

16 
17 

20 



INVALID FNT 
ADDRESS/ORDINAL 



INVALID FORMS CODE 



INVALID TID. 



21 



INVALID ORIGIN TYPE. 



Desc ript ion 

Function 1 (GET queued 
file) attempted to attach 
a file to a control point 
which had a file with the 
same name already attached. 

The number of reply 
entries requested from 
function 2 (PEEK) must be 
greater than zero. 

Reserved. 

The FNT address/ordinal is 
out of the range of the 
FNT. 

Reserved. 

Forms code specified is 
not two alphanumeric 
characters. 

May occur in one of the 
following situations. 

• Family name/user number 
specified is invalid 

• Specified TID for a 
batch or system origin 
job is greater than IDLM 

• Function (ALTER) is 
attempting to change the 
destination origin of a 
file without specifying 

a destination TID 

The origin type specified 
in the parameter block is 
i nva lid. 
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•„ r. rt ..-f- ■; n*> resident subroutines, and 
QAC is structured into a mam routine, resiaen 

the following function processors. 



3QR 
3QS 
3QT 
3QU 



Error processor overlay 
GET function overlay 
ALTER function overlay 
PEEK/COUNT function overlay 



All SAC functions use the sane search routi nes loc.t ed i^n the 
resident subrout ine area QAC a «P « l^.te . ^^ 
rornr::4^) a to P ::ri b d l tnIrrirth:^:rrh: y ad ( :f readin, .ueued 

f i le system sectors . 

u ««,,>inoQ are VCI (validate central memory 

::.SK.:;.a:.rs:;.::;?= : »::»;- * «c*!ri:^.. 

flowchart of the validation and Interlocking Tor 
figure 34-3 . 

u ■ < n«r ,„n blocks. This is accomplished 
Q-AC can process a chain of a , AC J*L parameter block. Once QAC 
by the link field in "° rd »" ?*■ .^"^^iS ',, checked. If 
is finished with a parameter block, „Ln»ri and QAC releases the 
zero, there is no further Processing needed «d «C rei 

proper order. 
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Figure 34-3- QAC Search 
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found in the FNT/FST and system sector of queued 
file has been found and interlocked, QAC is able 



It is the validation routines 

routing fields 

f i les . Once a 

to perform one of its functions upon 

QAC Preset 



(VCI and VMI) that make use of the 



the f i le- 



an d identifies the 



x n«r wai-iriai-oQ the function and identities in 
The oreset phase of QAC validates me lun *' 1 
ine pto«-i. H n( ,. nflrt j., n f the function, such as, FNT 

function processors and properties oT tne run ' oriority 
ordinal passed in QAC block, p r i o n t y of 7777B i L Legai L ^ priority 
is search criteria, and forms code not search criteria. 



Function - ALTER 



fields in a queue file or an 



The ALTER function changes requested _ fU and/or 

job file system sector and FNT/FST for an nies 



executing 



jobs matching the selection criteria, 
call block include the following. 



e quired fields in the 



Req 



Function code (=0) and cleared completion bit 
Queue type (more than one may be specified) 
Alter flags 



Origin type 



The beginning of FNT sea 

message text, and file/job name may 

search criteria. 



rch address, device selection, TID, 

optionally be specified as 



The code to a 



Iter a queued file is found on overlay 3QT. 

to be performed is determined by 



The alteration that is requested 

tSMlt" flag, in the call block. The flags incLud. the 

f o I lowi ng . 

Send to central site 
Change terminal ID (TID) 
Change priority 
Change forms code 
Change repeat count 
Abort j ob/evi ct file 
Change spacing code 
Send to Central Site (Output Files) 
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Change Terminal ID (TID) 

The alteration of the terminal ID is done in both the FST and 
system sector (DISS through DISS+1). For system and batch origins 
the terminal ID must be less than IDLM (70). 

Change Priority (Output Files) 

The alteration of queue file priority is done within the bounds 
of the service limits for the origin type of the file as 
determined by QUEUE parameter settings 
in the FST and system sector (PRSS). 



The new priority is set 



Change Forms Code (Output Files) 

The new forms code is validated by common deck COMPVFC. A valid 
forms code is any combination of two alphanumeric character or 
null. If the forms code is a special forms code (greater or 
equal to AG), it is set only in the system sector (FCSS). 
Otherwise it is set in the FST as well. A special forms code is 
any code that is not null, AA, AB, AC, AD, AE, or AF. These 
nonspecial values provide the optimum performance since only 
they can be represented by the 3 bits available for forms code 
in the FST. 

Change Repeat Count 

The repeat count supplied in the call block is set into the 
system sector (RCSS). 

Change Spacing Code 

The spacing code supplied in the call block is set into the 
system sector (SCSS). 

Abort Job 

The abort job option reads the optional message, writes it to 
the dayfile (system and control point) and sets the operator 
drop error flag (ODET) by the CEFM monitor function. QAC will 
change control points to issue the message and set the error 
f lag . 

If the job was not at a control point (that is, rolled out), the 
control point area is read from the rollout file, the message is 
written into MS1W, the operator drop error code (ODET) set into 
MS2W, and the control point sector rewritten. The priority of 
the rollout file is set to SEPS (special error priority) for 
appropriate processing by the scheduler and rollin mechanism. 

Evi ct F i le 

If a queued file is being dropped, an accounting message with 
identifier AEPQ is issued to the account dayfile and the file 
dropped via a call to ODF. 
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Function 1 - GET 

The GET function attaches a print or punch file to the requesting 
me bt Tuntiiun , ., soecified in the parameter block 

control point If ' P « e ound ,„ t „, FNT search that 

is Less than 7777B, trie T1 . . .. ,„l,_,j T f the orioritv is 
meets the "lection criteria ,s attached b ^^J-^^ 

7777B, the •n tir ?/ M T 1 » »""J priority file). Required fields 

^%r/« t t , i on bi«i t ;"r'tiS!: l s£'T 5--;?:; i^^ *,. <?^«*. 

. Function code (=1) and cleared completion bit 

• Queue type 
•Priority 

• Origin type 

The file name, forms code, disposition code, starting FNT 

ordinal, destination terminal ID, and inhibit duplicate tue 

search flag may be optionally specified. 

The code for attaching the selected queued file is contained in 

overlay 3QS. 

If a f1le that mee ts the selection criteria is found, information 

o ,' . U." returned to the -Her in the parameter block 
and an updated FNT/FST entry bui t or h J^/^aymr 
control point. The information [ e ™'" fU eat beqinning of 

^rftia^rftar/^^L^rngfh ^rk s ri e hr^ b h ? LSS+1 ?. 

uh .,, the resDOn se is being formatted and FNT/FST updated, the 

e'islno^oually inter?ocked by the .FIT jnterloc mechanism 
(SFIM) and the FNT interlocked using the FNCT channel. 



Function 2 - PEEK 

The PEEK function returns a list of responses for filet .nd J°bs 
matching the selection criteria. The required fields in the 
parameter block for a PEEK include the following. 






Function code (=2) and cleared completion bit 

Priority 

First word address (FWA) of reply buffer 

Queue type 

• Number of replies 

• Origi n type 

The file/job name, terminal ID ^^^^ ^U^" V^cU 
and starting FNT ordinal may optionally be specuieu 

criteria. 

34-35 
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The first two words of the PEEK reply buffer are formatted as 
follows. 



59 




35 


17 







^^ 


^^ 


lene 


lenb 


info bits 


buffer for reply entries 



lene 
lenb 



Length of reply entries returned by QAC/PEEK. 
Length of buffer to receive reply entries- 



info bits Each bit represents a different word of 

information that can be returned. If a bit is 
set, the corresponding information is returned as 
an additional word to the reply entry. The lower 
six bits (bits 5-0) of each additional word 
returned contain an information number that may 
be used to identify the type of information in 
that word. 

Table 34-1 defines the information bits and information number 
for each type of information that can be requested. 



TABLE 34-1. INFORMATION BITS 









I 


nf orma t i on 


|Bit 


Information Requested 




N 


umber 




No information in word 









I o 


Not used 






- 


I 1 


Destination family name 






1 


I 2 


Destination user number 






2 


I 3 


Creation family name 






3 


I 4 


Creation user number 






4 


I 5 


Job statement name 






5 


I 6 


Equipment, queue type, < 
I i ne/ card limit 


and 




6 


I 7 


Creation date, creation 


TID 




7 
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4. ~-p +^0 pffk reoLv entry when all information is 
The format of the Pbu repty c"u; 

requested is as follows. 



59 



ADDR+O 
+ 1 
+ 2 
+ 3 
+4 
+ 5 
+6 
+7 
+ 10 
+ 11 



47 



35 



17 



job/file name 



ot 



no change 



no change 



destination family name 



destination user number 



creation family name 



creation user number 



job statement name 



eq 



qt 



creation date 



line/card limit 



creation tid 



11 





priority 




/ 




» 




/. 



7 



z 



2 







A 



The co 



ot Origin type: 

System origin 

1 Batch origin 

2 Remote batch orig'in 

Equipment number file resides on 

Queue type: 

1 Input f i le type 

2 Print file type 

3 Punch file type 

de for the PEEK function is found in overlay 3QU 



eq 
qt 
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The response returned if an executing job satisfies the search 
criteria has the following format. 



59 




47 


; 


IS 


23 


17 


11 






file name 


origin 
type 


priority 


W> 


W/. 


SRU accumulated 


FL/100 


job ordinal 


¥a 




'WW/. 


stat 


TID 



stat Job status: 

10 Job rolled out 

02 Job at control point 

The response returned if an input file satisfies the search 
criteria has the following format. 



59 



23 17 11 



file name 




origin 
type 




Z 




priority 



FNT ordinal 



destination TID 



The response returned if a print/punch file satisfies the search 
criteria has the following format. 



59 53 47 



23 17 



11 




origin 
type 



forms code 



priority 



FNT ordinal 



destination TID 



i File interrupted (if set = 1) 
re Repeat count 

disp Disposition code (this field contains internal 
and external characteristics and device code) 
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If the extended information bit is set in the call block, the 
forms code, interrupt flag, repeat count, file size, and 
disposition code (internal/external character! st res) are 
returned . 



Function 3 - COUNT 

The COUNT function counts the number of files and/or jobs of a 
specified type satisfying the selection criteria. Multiple 
types can be set in a single COUNT request with the 
returned to the caller. The required 
COUNT call include the following. 



queue 

of each type being 

parameters for the 



count 



Function code (=3) and cleared completion bit 



• Queue type 

• Priority 

• Origin. type 



The terminal ID, starting FNT ordinal, disposition code, and 
file/job name may be specified as optional search criteria. 

The queue type, disposition code, FNT address, priority and 
file/job name are also returned for the first file that meets 
the selection criteria. 

The code for the COUNT function is also found in overlay 3QS. 



QAC - KEY RESIDENT SUBROUTINES 

The following paragraphs describe key resident QAC subroutines. 

SEJ - Search for Executing Job 

SEJ scans the FNT for queued, files which represent jobs in an 
executing state, namely INFT (at a controL point), ROFT (rolled 
out), or TEFT (timed/event rolled out). If one of these types 
s found, subroutine VCI is called to compare the selection 
riteria with information about the job that is normally found 



i 
c 
i n 



the control point area. 



If a job has been selected, its 
FNT interlock mechanism CSFIM). 
and VCI called again to recheck 



FNT entry is interlocked via the 

The queue type is revalidated 
the selection criteria since 



information about the job could have changed while waiting for 
the FNT entry to be interlocked or it may be a different job. 
the recheck rejects the job, the interlock is cleared and the 
next FNT entry is examined. 

If the recheck verifies the job as satisfying the selection 
criteria, subroutine VMI is called to compare the selection 
criteria with information about the job that is normally found 
in the system sector or FNT/FST for it. If this comparison is 
successful, a job found status is returned to the caller. 



If 
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SFF - Search For Fi le 

SFF scans the FNT for queued files having the desired selection 
criteria. The logic is similar to that found in SEJ except that 
the information processed is related to files rather than jobs. 
VCI is called to compare selection criteria that is control point 
related. If a candidate is found, it is interlocked and VCI 
called to recheck the selection. If the recheck rejects the file, 
the interlock is cleared. If the recheck is successful, VMI is 
called to compare selection criteria that is FNT/FST or system 
sector resident. If this comparison is successful, the FNT 
address of the file is returned to the caller. 

VCI - Validate Central Memory Information 

VCI compares selection criteria with information normally found 
in the control point area. The processing done by VCI is 
dependent upon the type of queue selection (job vs file) and 
check or recheck. 

In the queued file check and recheck case (call is from SFF), 
the file must not be assigned to a control point, must match the 
desired queue type, must match the desired priority (if this is 
a selection criterion), and must match the job name and origin 
type (if these are selection criteria). 

In the executing job case of a job at a control point (file type 
is INFT), the input file must be assigned to a control point 
(that is, not in the queue), must be the job's input file, 
and must match the job name and origin type (if these are . 
selection criteria). In the recheck case, the control point area 




In the case of rollout files, whether ROFT or TEFT, the read 
rollout file flag is set. The job name and origin must agree 
with the selection criteria if so specified. 

VCI is flowcharted as figure 34-4. 



60454300 A 34-40 



|jMT . flMH n- -«« storage Information 

with information contained 



VMI compares the selection 



■rthrfUe's^NT/FST or sy s tern' sec to r . 

job files CROFT), the fi Le's 




For at 

compa 

not agree. 



Ll other cueued file types the d.,1r.d terminal 
red with the FST and a not found status r^u 
The forms code is then compared. 



IDs is 

if they do 
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yes 



no 



yes 





i4 1 



© 



/vCMOj 



Figure 34-4. VCI - Validate Control Point Information 
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rollout 
validation 




Figure 34-4. VCI 



Validate Control Point Information 
(Continued) 
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If forms code is not a selection criterion, the device code is 
checked- If the file is a special queued file (d/x fields equal 
SPDV), the forms code is compared with the system sector. If the 
file is not a special queued file, the forms code from the FST is 
compared with the selection criterion- If a match occurs, the 
device code is checked. If a match does not occur and the forms 
code from the FST is not an extended code, a not found status is 
returned. If the forms code is an extended code, the system 
sector is read, and the forms code (FCSS) is compared with the 
selection criterion. If no match occurs, a not found status is 
returned. If matching the device code check is made. 

If device code is not a selection criterion, and the file is not 
EIOT, a found status is returned. A found status is also 
returned for EIOT files with matching family names. If the file 
is a special queued file (file ID is SPDV) and extended codes are 
available, the device code validation is done using the system 
sector. If not a special queued file, and any device can be 
used, the external characteristics are checked. If a device code 
is specified, the device code from the FST is compared with the 
selection criterion. If a match occurs, the external 
characteristics are checked. If a match does not occur, not 
found status is returned. If the comparison for device code is 
to be made from the system sector, the sector is read and the 
device code (DVSS) compared with the selection criterion. If no 
match occurs, a not found status is returned. If matching, the 
external characteristics are checked. 

If the file is a special queued file (greater than SPDV), the 
external characteristics are processed from the system sector. If 
the external characteristic are extended values, they are also 
processed from the system sector. If external characteristics 
are specified in the FST and do not match the selection 
criterion, a not found status is returned. If any printer can be 
used, and not EIOT, a found status is returned; if EIOT and 
matching family names, found is also returned. If the 
characteristics must be processed from the system sector, the 
system sector is read and the external characteristics (ECSS) are 
compared to the selection criterion. If no match occurs, a not 
found status is returned. If matching, t he EIOT/f ami ly check 
must agree before the found status is returned. 

VMI is flowcharted as figure 34-5. 
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Figure 34-5. VMI - Validate Mass Storage Information 
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Figure 34-5. VMI - Validate Mass Storage Information (Continued) 
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*1 Input conditions for VMI13: 

= match, 1 = no match or error 

Mflur. 34-5. VII - Validate Mass Storage mformation (Continued) 
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Figure 34-5. VMI - Validate Mass Storage Information (Continued) 



60454300 A 



34-48 




Figure 34-5. VII " Validate Mass Storage Information (Continued) 
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In summary, for output files with matching terminal IDs, compare 
forms code, device code, and external characteristics (if 
selection criteria) with FST if not a SPDV file. If SPDV or 
forms code, device code, and external characteristics are 
extended, compare the selection criteria to their system sector 
values. If no match occurs, return not found. If a match 
occurs and file is not EIOT, return found. If file is EIOT, 
return found if family names compare; not found if otherwise. 
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REPRIEVE PROCESSING CRPV) 35 



REPRIEVE OVERVIEW 

Reprieve CRPV) allows a CPU program to perform the following 

f unct ions . 

. Declare an address to which control is returned after 
execution has been stopped by an er ror a jr.i 
interrupt, or normal job termination. These cases are 
called interrupts. 

. Resume execution of an interrupted program at the point 
of interrupt. 



• Reset an error flag which resulted in a reprieve so 
that job exit processing can occur. 

Renrieve processing is controlled by calls to the PP program 
rp5- RPv'consisis of two functions which previously resided in 




RA+1 CALL 

The format of the call to. RPV is as follows 



59 



RA + 1 



40 



RPV 



FT* 

',< 

/ 

Am 



17 







addr 







addr First word 
b lock 



address of the parameter 



REPRIEVE FUNCTIONS 

RPV supports the following functions 



Setup 

Resume 

Reset 



The setup function is used to initialize the parameters o the 
RPV interface (that is, setting the mask bi ts that inch cat e 
which errors are to be intercepted). It also J^t^ l ;"» « \\ 
RPV data in the user's control point area and if the parameter 
bUck indicates pending interrupts or I/O requests, these are 
processed at that time. 
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The resume function is used to restart the program after an 
interrupt has been processed. Any pending interrupts that 
occurred during the processing of the previous interrupt 
are detected then and the interrupt handler is restarted to 
process these interrupts. Optionally, the mask bi ts may also 
be changed during the resume function. 

The reset function is used to reset a previous error and^allow 
the operating system error handling to process the error. That 
is, the error is processed by the system as if the appropriate 
mask bit had not been set. Pending interrupts are not 
processed; however, any pending RA+1 request is reset. 

PARAMETER BLOCK 

The format of the parameter block is as follows. 



addr+O 
+ 1 
+ 2 
+ 3 
+4 
+ 5 
+6 
+ 7 
+ 10 
+1 



59 



'1 



+ 30 



35 



29 23 



17 



11 9 



checksum Iwa 



length 



tunc |c 



transfer address 



checksum value 



mask 



error class 



error code 



pending interrupts 



pending RA+1 request 



interrupted terminal I/O 



reserved 



reserved 



error flag 



reserved inst. 



exchange package 



1 



length 



f unc 



Length of the parameter block including 
the exchange package area Cminimum of 25 
( 31 B) words:. " 

Funct ion code : 

1 Setup 

2 Resume 

3 Reset 
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checksum Iwa 



t ransfer 
address 

checksum value 



mask 



error class 



error code 



pending 
i nterrupt 



Completion bit (set when operation is 
comp let e) . 

Specified by the user to indicate the end 
of the area to be checksummed and 
compared or set. If zero, no checksum is 
desired (checksum area begins at transfer 
address) . 

Address to which control is transferred 
when an interrupt is processed. 

Either set to the checksum of the 
indicated area when RPV is called or 
compared against the computed checksum 
(if checksum Iwa is specified) when a 
reprievable error is processed. 

Mask bits to be set by call (specifies 
class of interrupts to be intercepted): 



mask 

001 
002 
004 
010 
020 
040 
100 
200 



Description 

CPU error exit 
PP call error 
Resource limit 
Operator termination 
PP abort 
CPU abort 

Normal termination 
Terminal interrupt 



Set to the value of the mask bit which 
intercepts the indicated error (that is, 
if error x is intercepted by mask bit n, 
then bit n in the error class field is 
set). Refer to table 35-1 for a list of 
error classes. 

Octal code indicating error encountered. 
Refer to table 35-1 for a list of error 
codes and their meanings. 

Used to queue pending interrupts (that is, 
the nth error code sets bit n in this 
field) . 



pending RA+1 
r eques t 



i nt er rupt ed 
terminal 1/0 



Contents of RA+1 at time of interrupt. 
RA+1 reset from this field on a resume or 
r eset ca 1 1 . 



Contains interrupted input requestif an 
interrupt occurs while a terminal input 
request is pending 
f o I lows . 



The format is as 
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59 



35 



17 



CIOP 





FET address 



The CIO call is reissued on a resume call 



error f lag 



rese rved i ns t 



exchange 
package 



Value of the operating system error flag 
at the time of the interrupt (refer to 
section 2 for a list of error flags). 

This area is reserved for use by the 
installation. 

A copy of the exchange package at the 
time of the interrupt (unchanged from the 
executing package at the time of the 
error). This is the exchange package 
that is used when the interrupt handler 
is started. A reset or resume call sets 
the running control point registers from 
t hi s area . 



Table 35-1 lists the return information for RPV error codes, 
classes, and flags. The operator kill error (OKET) is only 
reprieved once per job. The first time it is handled as any 
other error; however, the second occurrence unconditionally 
terminates the job. Additionally, reprieve processing is not 
allowed on a system abort error (SYET) or override error (ORET) 
for security reasons. 
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TABLE 35-1. RPV ERROR CODES, CLASSES, FLAGS 



error 
code 



Description 



error 
class 



Cor respondi ng 
Error Flags 



10 
11 
12 
15 
16 
17 
20 



21 
40 



Normal termination 
Time limit 
CPU error exit 
PP abort 
CPU abort 
PP call error 
Operator drop 
Ope rat or kill 



Operator rerun 

Control statement error 

ECS pari ty error 

Auto reca U error 

Job hung inautorecall 

Mass storage limit 

PP program not in 

library 

I/O limits 
Terminal interrupt 



100 
004 
001 
020 
040 
002 
010 
010 



010 
040 
020 
002 
002 
004 
002 



004 
200 



None 

TLET 

ARET, 

PPET 

CPET 

PCET 

0DET 

SSET, 

SYET, 

RRET 

None 

ECET 

None 

None 

FLET, 

None 



SRET 
TIET 



PSET 



0KET, 
FSET 



0RET, 



TKET 



CONTROL POINT AREA USE 

Word EECW of the user's control pointarea is formatted as 
follows for extended reprieve processing. 



59 55 



35 




17 



terminal 
input pointer 



addr 



fig 



Flags; each bit defined as follows: 



Bi t 

59 
58 
57 

56 



Desc ri pt i on 

Not used by extended RPV 

Extended RPV active 

Interrupt handler in 

progress 

One-time error entered 
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mask Mask bits as described in parameter 
block 

addr RPV parameter block address 



Bit 58 is 
reprieve 
DISTC add 
is set w h 
hand ler a 
occurs wh 
the param 
a I lowed t 
error i ni 
error) . 
the job i 
initially 
occur renc 
by the ma 
are set i 



set on a 
is act i ve, 
ress) cont 
enever the 
t the tran 
i le this b 
eter block 
o continue 
t i ated by 
In this ca 
s aborted. 

repri eved 
e of a one 
s k bits, 
n EECW by 



setup o 

bi ts 3 
ain the 

system 
sf er ad 
i t i s s 

and pr 

An e 

the i nt 

se the 

Bit5 

( cur re 
-t i me e 
The mas 
a setup 



r re 

5 th 
pre 
(1 A 

dres 

et, 

oces 

xcep 

erru 

i nte 

6 i s 
nt ly 
r ror 
k bi 

or 



sume 
roug 
vi ou 
J or 
s . 
the 
sing 
t i on 
pt h 
rrup 
set 
on I 
i s 
t s a 
resu 



ca I 
h 23 
s er 

1RI 
If a 
i nte 

of 

i s 
and I 
t i s 

whe 
y OK 
not 
nd p 
me c 



I. When extended 

of TIAW (otherwise the 
ror flag value. Bit 57 
) starts the interrupt 

subsequent interrupt 
rrupt is set pending in 
the first interrupt is 
if the interrupt was an 
er (such as an arithmetic 

not set pendi ng and 
n a one-time error is 
ET) . The second 
reprieved even if selected 
arameter block address 
all. 



SETUP FUNCTION 



This function is used to initialize the parameters for the RPV 
interface. It sets the mask bits which indicate which errors 
are to be intercepted and initializes all RPV data in the 
control point area. If the parameter block i ndi cat es pendi ng 
interrupts or I/O requests, these are processed at this time. 

The setup reprieve function is processed in the following 
manner. 

1. Abort if one of the following parameter errors. 

• Length less than 31B words 

• FWA (addr) plus length greater than FL 



Checksum LWA nonzero and less than transfer 
address 

Checksum LWA less than 2 or greater than or 
equa I to FL 

Transfer address less than 2 or greater than or 
equaltoFL 

Undefined mask bit specified 

RPV called without autorecall 
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The following values a 
EECW. 



re set in the control point word 



• Extended RPV flag 
i RPV mask 

• FWA of parameter block 

. Previous error flag is invalidated 

If pending interrupts are nonzero, perform the 
f o I lowi ng . 

Validate pending interrupts (that is, is pending 

interrupt of defined error) 

Select highest priority interrupt 

Clear selected interrupt bit in pending 

i nt e r rupt s 

Set return status flags (error number, error 

class, and so on) 

Set interrupt handler active 

Set running P register to transfer address 

Reset running registers from the parameter block 
(except P) 

Set comp le t e bit 
Return 



If pending interrupt equals zero, perform the 
f o I lowi ng - 

• Compute checksum if LWA nonzero 

• Clear interrupt handler in progress 

• Reset RA+1 from parameter block 



ttear n-rameter block fields used (pending RA+1 
request word, interrupted terminal I/O word, and 



Clear pa 

q 
so on) 



• Set complete bit 

• Request CPU 

. initiate pending terminal input (call CIO over 
RPV) 
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RESUME FUNCTION 

This function is used to restart the running program after an 
interrupt has been processed. Any pending interrupts which 
occurred during the processing of the initial interrupt are 
detected at this time and the interrupt handler is restarted to 
process these interrupts. Opt i ona I ly , t he mask bits can also be 
changed at this time. The processing of RESUME is identical to 
that of SETUP except that the running registers are set from the 
pa rameter block . 

The resume reprieve function is processed in the following 
manne r . 

1. Abort if parameter error. 

• Length of parameter block less than 31B 

• Parameter block outside of FL 

e Checksum LWA nonzero and less than transfer 
address 

• Checksum LWA less than 2 or greater than or 
equal to FL 

• Transfer address less than 2 or greater than or 
equal to FL 

• Undefined mask bit specified 

• RPV called without autorecall 

2. Set control point values in EECW. 

• Set new mask bits 

• Set FW A of RPV area 

• Set extended RPV flag 

• Invalidate previous error flag 



If pending interrupts nonzero. 

• Validate pending interrupts (that is, pending 
interrupt is a defined error) 

• Select highest priority interrupt 

• Clear selected interrupt bit in pending 
i nt errupt s 

• Reset running exchange package (except P) 
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• set return status flags (error number, error 
class, and so on) 

• Set interrupt handler active 

• Set running P register to transfer address 

• set complete bit 
e Return 



4. If pending interrupt zero 



Compute checksum if LWA nonzero 

Clear interrupt handler in progress 

Reset running exchange package (including P) and 
RA+1 from parameter block 

Clear parameter block fields used ^^^/^ 
request word, interrupted terminal I/O word, and 

so on) 

Set complete bit 

Initiate pending terminal input (call CIO over 
RPV) 



RESET FUNCTION 



revious error and allow the 




coming from the users FL) 

The reset reprieve function is processed in the following 



manner 
1 



Abo 



t if parameter error . 

RPV extended mode not set 

Length of parameter block less than 31B 

Parameter block outside of FL 

Transfer address less than 2 or greater than or 
equa I to FL 

Undefined mask bit specified 
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• RPV called without autorecall 

• Interrupt handler not active 

• Previous error flag not set (invalid) 

2. Reset error flag to previous error flag (from TIAW). 

3. Reset previous job. 

• Clear mask bits (turn off further RPV processing) 

• Clear interrupt handler in progress 

• Reset running exchange package (including P) and 
RA+1 from parameter block 

• Set comp lete bi t 

INTERRUPT PROCESSING FOR EXTENDED RPV 

The following is the processing taken by the system (1AJ or 1RI) 
when an interrupt occurs. Error flags and normal termination 
are processed by 1AJ. Terminal interrupts are processed by 1RI. 

1. Abort job if mask bit for error not set. 

2. If error flag has undefined mapping, hang. 

3. Abort if parameter error. 

• RPV extended mode not set 

• Length of parameter block less than 31B 

• Parameter block outside of FL 

• Checksum LWA nonzero and less than transfer 
addres s 

• Checksum LWA less than 2 or greater than or 
equa I to FL 

• Transfer address less than 2 or greater than or 
equal to FL 
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4. If interrupt handler not active. 

• Abort if checksum mismatch 

• Move error flag to previous error flag 

• Copy exchange package to user return package 

• Set system dependent and common error codes 

• Copy contents of RA+1 

• Clear RA+1 

• Reconstruct terminal input request (if present); 
if no request present, store zero 

• Set running P register to transfer address 

• Clear error flag 

• Set interrupt handler in progress 

• Return 



5. If interrupt handler active. 

• Abort if execution initiated interrupt (error 
codes 0, 2, 3, 4, 5, 11, 15, 16, 20) 

• Set pending error in pending interrupt status 
word in request block 

• C lear error f lag 

• Return 



TERMINAL INPUT REQUESTED 



request for terminal input is 



If an interrupt occurs while a request tor ter na^.-pu - 
pending, control is given to the Interrupt hand er in such a 
Sav that the I/O request can be reissued after interrupt 
processing has been\omp let ed . The mechanism for .cco.pli.hin 
this is as f o I lows . 

1. Do not set the FET complete. 

2. Set no error code in the FET. 



3. 



4. 



No data is passed to the buffer (IN/OUT remain 
unchanged) . 

Reconstruct the CIO request which initiated th 
request and pass it to the interrupt handler i 
interrupted terminal input request word of the 
package; this word is zero if the program was 
waiting for terminal input 
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INT ERRUPT FLOW 

Figure 35-1 describes the flow of control during the processing 
of an interrupt. The module performing a function is enclosed 
i n pa rent heses . 

Figure 35-2 is a flowchart illustrating 1AJ interrupt 
processing. Figure 35-3 shows the processing by 1R0 when a 
terminal job is to be returned to time-sharing executive control 
following a terminal interrupt. Figure 35-4 flowcharts 1RI 
processing when a terminal job is given control back following a 
terminal i nt e rrupt . 
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initiate job 




error detected 

(CPUMTR or 

CEFM) 



1AJ 



process error 




TS regains 
control 
(1T0/VAS0) 



user break entered 



set interrupt 

flag in 
terminal table 




user break 
entered 




yes 



return job to 
TS (1TA - 
null VASO) 



schedule job 

for rollout 

OTA) 



rollout job 
(1R0-VAS0) 



I 



Figure 35-1. Interrupt Processing 
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enter job in 

rollout queue 

(1TA) 



rollin job 
(1RI) 



C 



abort job 




continue 

execution 

at interrupt 

handler 



I 



RPV 



issue 
RESUME 
function 




yes 




C return to \ 
original J 

execution _y 



Figure 35-1. Interrupt Processing (Continued) 
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preset 

1AJ 

(monitor call) 



3AB 

1AJ error 
processor 



clear error flag 



clear pause bit 



store sense 
switches 








yes 



( abort job J 




no 



validate 
parameters 




no 



© 



set pending 
interrupt 







1 SYET, ORET, second OKET, or fatal mainframe error. 



Figure 35-2. 1AJ Interrupt Processing 
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process 
error 
flag 



( return J 




validate 

checksum 

if requested 



set previous 
error flag 



clear mask bits 



map error 

flag to NOS/BE 

equivalent 



store RA+1 



store 

exchange 

package 



issue message: 

JOB 
REPRIEVED 



reset P 
register 



increment 
limit 



request 
CPU 








no 



( exit ) 



Figure 35-2. 1AJ Interrupt Processing (Continued) 
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exchange 

package 
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f 
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Figure 35-2. 1AJ Interrupt Processing (Continued) 
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no 




preset rollout 



enter rollout file 
into FNT 




check buffer 
parameters 



set input 
request in 
terminal table 
/REM/VIPR 





request 
mass storage 



clear 
equipments 



clear FNT 
entries 



read 

output 

data 

(first sector) 



set output 
available in 
terminal table 
/REM/VOPR 



yes 



write control 
point area, day- 
file buffer, FNTs r 
terminal output, 
job field 
length 
to rollout file 




check 

error 

message 



Figure 35-3. 1RO Interrupt Processing 
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update 

terminal 

table 




no 



Jr terminate roll- A 
\ out to queue ) 



clear control 

point area 

and job advance 



change to 

time-sharing 

control point 

and call 1T0 *2 



*1 Input requested, output available, job termination or 
forced ro I lout . 



* 2 Refer to figure 15-22 



Figure 35-3. 1R0 Interrupt Processing (Continued) 



60454300 A 



35-19 




preset 
rollin 



read system 
sector of 
rollout file 



clear time-sharing 
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in terminal table 



read control 

point area, 

dayfile buffer, 

and FNT 





validate 
parameters 



copy 
exchange 
package 




set P to 
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set flag 



Figure 35-4. 1RI Interrupt Processing 
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input 

data >*■ 

present 



copy input 
data to 
user FL 



update 
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pointers 



update 
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drop 
input 
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Figure 35-4. 1RI Interrupt Processing (Continued) 
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Figure 35-4. 1RI Interrupt Processing (Continued) 
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PERMANENT FILE UTILITIES 



36 



INTRODUCTION 

The permanent file utilities are used to maintain the permanent 
file system. These utilities provide for the dumping and 
loading of permanent files, the cataloging of files in the 
system and on an archive tape, and the copying of specific 
files to a control point. 

The permanent file utilities consist of the following. 

Permanent file supervisor (PFS) 

Permanent file utility processor (PFU) 

Dump permanent files (PFDUMP) 

Load permanent files (PFLOAD) 

Catalog permanent file device (PFCAT) 

Catalog archive tape (PFATC) 

Copy archived files to control point (PFCOPY) 

These utilities can be initiated from system origin jobs or by 
users with system origin privileges and DEBUG mode on at the 
conso le . 

This section assumes that the reader is familiar with NOS 
permanent file concepts. If a review of these concepts is 
needed, the NOS System Maintenance Reference Manual is 
recommended, not only for PF concepts but for the external 
properties of the permanent file utilities themselves. 

PFS - PERMANENT FILE SUPERVISOR 

PFS processes the permanent file utility control statements. 
It performs parameter processing for all of the utilities for 
both control statement and K-display parameter entries. After 
the arguments have been processed, PFS loads the desired 
utility. 

Where possible, the available parameters for the utilities are 
compatible; that is, a parameter (FM for example) means the 
same (family name) in each of the utilities for which it is 
applicable. 

A list of the parameters and the utilities for which they are 

applicable is shown in table 36-1. Refer to the NOS System 

Maintenance Reference Manual for a complete description of the 
parameters . 
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TABLE 36-1. PARAMETERS AND UTILITIES 



Param.l Description 



PFLOAD 



FDUMP 



PFCAT 



PFATC 



PFCOPY 



FM 
PN 
DN 
TD 

T 
LO 



L 
OP 



EO 
NT 
NR 
NU 
SF 

N 

DT 



F am i ly name 

Pack name 

Device numbe r 

True device number 

Archive file name 

List option 

T Fi Les processed 

C Catalog files 

E Er rors 

S Summary 

Output file name 

Utility option 

C Creat i on 

A Last access 

M Last modification 

I Indirect 

D Di rect 

B Before date and 

t ime 

p Purge after dump 

R Replace 

Q Catalog and permit 

records 

N Noni ni t i a I 

E Extract cir only 

Omi t cir 

Error opt i on 

Ni ne track 

No rewind 

No unload 

Number of f i les to 
skip 

Number of files to 
process 

Date 



X 
X 
X 
X 
X 
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TABLE 36-1 . 



PARAME 



TERS AND UTILITIES (CONTINUED) 



Param 

TM 
UI 

PF 

DI 

VF 
V 

DD 

UN 
MF 



Description 

Ti me 

User index 

Permanent file name 

Destination user 
index 

Veri fy f i Le name 

Ve ri f y f i l e 
generation 

Destination device 
number 

User number 

I Master file name 



jPFLOAD 

I 

I X 

I 

I X 

I 

I X 

X 



FDUMPl PFCAT I PFATC 



X 
X 
X 



X 
X 
X 



X 
X 
X 



PFCOPY 

X 
X 
X 



PFS has two nodes of entry: entered a ^ % F * 0P y, PFOUHP 
the permanent file utilities <"*",. PF«, e ntry pom", PF 
PFLOAO). When entered at one of *Je u i l«y alte ters was 

.u« v Hi.nlav only if one of the entereo |i» uses tne 
uses the K display onuy ■ entry point, PF5 u * 

i n 5^ r P :.5-fo-r h "itrt-/:s-' t p. t r.:.;: 8 r..i.^?on. 



The 



PFS first r , ^^^^<^^ C l^ 
^o^rHter p^eter^a^speci f i es the utility. These 
values are as follows. 



Pa ramet er 


Utility 


AT 


PFATC 


CA 


| PFCAT 


CP 


| PFCOPY 


DU 


| PFDUMP 


LD 


| PFLOAD 




entries for the individual utilities. 

have been processed, the individual 



After all parameters 



utility overlay is loaded via an OVERLAY macro request 



and 
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control transferred to it. The utility is loaded at one of two 
addresses: OVLA or OVLB. The difference between these 
addresses is that OVLB includes PFS's keyboard entry processor 
as resident code while OVLA does not. This allows the PFDUMP 
and PFLOAD utilties to further communicate with the operator 
during execution. Since PFATC, PFCAT, and PFCOPY require no 
subsequent console intervention they are loaded at OVLA, while 
PFDUMP and PFLOAD are loaded at OVLB. A memory map of PFS's 
field length is shown as figure 36-1. 

The communication between PFS and the utilities is facilitated 
by common deck COMSPFS. This common deck contains location 
symbols for the K display, converted parameter area, keyboard 
input processor, and utility load addresses so that each 
utility is able to find the parameters PFS has processed and 
continue to communicate with the operator's console as 
necessary via the K display. 

Parameter processing consists of cracking arguments entered by 
a control statement or through console entry, ultimately 
storing them in the table of converted parameters (PARC), 
position within PARC for each parameter is defined by the 
converted parameter location table in COMSPFS. 



The 



The entered parameters are processed by common deck C0MCAR6 and 
therefore require an equivalence table for the parameters. The 
call to ARG places the entered parameters into the table of 
entered parameters (PARE) at a position specified in the 
equivalence table that is defined by the option value table 
(OTBL). The parameters are read from PARE, interrogated, 
validated, and then stored in PARC. 

The validation of the parameters for a given utility is 
accomplished by using a bit position table defined for each 
utility. The utility valid option mask table has a one-word 
entry for each utility. This entry is generated by using the 
OPTION macro, defined in COMSPFS, which sets a bit in the word 
based on the value for the parameter as specified in the OTBL. 
Thus the nth entry of PARE is a valid option for the utility 
only if bit 5 9-n is set in the utility valid option mask table. 

This technique allows for a convenient shift and read mechanism 
to validate the variety of options available within the 
permanent file utilities. 

PFS processes the parameter conversion (moving the parameters 
from PARE to PARC) by groups in the following order. 

1. The name parameter group consists of those parameters 
which have their keyword equated to the name of the 
item. Name parameters are FM, PN, T, VF, L, PF, MF, 
and UN. 

2. The list option parameter group is the string of list 
options specified with the LO keyword. These options 
are unpacked from the string entry, validated, and 
stored in PARC by subroutine OCK (option cracker). 
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7 The utility option parameter group is the string of 

Utility options specified with the OP keyword These 
options a're unpacked from the string entry, validated, 
and stored in PARC by subroutine OCK. 

4. The octal parameter group consists of those parameters 
that are entered as octal values. These values are 
converted and stored as binary numbers in PARC The 
keywords in this group are UI, DI, DN, DD, and TD. 

5 The decimal parameter group consists of those 

parameters that are entered as decimal values. These 
values, entered with the N and SF keywords, are 
converted and stored as binary numbers in pakl. 

6. The single entry group consists of Jhose para.jteps 
that represent a flag setting to i ndicat e whet her t o 
perform a given operation or not. This group contains 
keywords NR, NU, V, NT, and EO. 

7 The final group consists of date and time. The yymmdd 
" entry for the DT keyword and the hhmmss entry t 
TM keyword are converted and stored in packed date and 
time format in PARC. 

The argument processing of PFS is flowcharted as figure 36-2. 
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RA 



RA + 101 



communication area 



overlay loading 

POC 

SSJ= block 



left screen K display 



right screen K display 



converted parameters table 



parameter addresses 



keyboard input processor 



OVCA 



DIS 



CPL 



PADR 



OVLA KIP *1 



OVLB -*2 



Figure 36-1. PF Utilities Memory Map 
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(pFCOPy) (pFDUMp) (PF 





set utility 
name for 
K display 



set argument 
and function 
processor for 
initial selection 



SVO 



set valid 
options 




move 
control 
statement 
arguments 



issue message 

ENTERED 

PARAMETER 

IS ILLEGAL 



set program 

name in 

PGNRto 

PFS 




show 
K display 



*1 Entry to KIP is set up to return to this address. 
Figure 36-2. PFS Argument Processing 



60454300 A 



36-7 



yes 




set up 
parameter 
processing 



clear ENTF 

and set as 

PFS entry 

in ENTP 





no 



set up to 
convert and 

validate 
arguments 



process 

name 

parameters 



I 



process 

list 
options 



process 

utility 

options 



process 

octal 

parameters 




Figure 36-2. PFS Argument Processing (Continued) 
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process 

decimal 

parameters 



process 

single 

entry 

parameters 



W 



process 
date 



process 
time 





issue message 
ENTERED 
PARAMETER 
IS ILLEGAL 



DDE 
determine 
default 
equipment 



set up to 

load utility 

overlay 




issue message 

ILLEGAL 

FUNCTION 



C 



abort 



clear 
K display 




POC K 



called 

asPFS 

[ENTF=( 





clear ENTF, 


^s^ no 


save 
utility 
in ENTP 




u . . 







Figure 36-2. PFS Argument Processing (Continued) 
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The following paragraphs describe the main subroutines in PFS 



POC - PROCESS OVERLAY CALL 

POC loads the individual permanent file utility and transfers 
cont rol to it. 



KIP - KEYBOARD PROCESSOR 

KIP unpacks input parameters that have been entered via the 
operator's console under K display control. 

KIP is entered with two exit addresses: one for argument 
processing and one for function processing. The argument 
processing address is used when processing argument parameters 
while the function processing address is used only when the GO 
parameter has been issued. 



CDT - CONVERT DATE AND TIME 

CDT converts the date and time from yymmdd and hhmmss to the 
system packed date and time format. 



DDE - DETERMINE DEFAULT EQUIPMENT 

DDE validates the use of the family name (FM) and pack name (PN) 
parameters. If both are specified the following diagnostic is 
issued, since these two parameters are mutually exclusive. 

BOTH FAMILY AND PACK NAME. 

The EST and MST are read using the RSB monitor function to 
verify the equipment is available by the specified name. If an 
entry is not found, the following diagnostic is issued. 

FAMILY/PACK NOT FOUND. 

If a private pack is being processed, the pack's user number 
and that supplied via the UN parameter must agree or no match 
occurs . 

If a user number (UN) has been specified, it is validated. If 
it is not valid, the following message is issued. 

USER NUMBER INVALID. 

DDE also verifies that if the PF parameter is used, the user 
index (UI) or user number (UN) has also been specified. If not, 
the following diagnostic is issued. 

PF SPECIFIED BUT NOT UI. 
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OCK - OPTION CHECK 



of options that are associated with 



OCK Drocesses the string . 

the LO and OP parameters. OCK unpacks the strmgs and 



validates the option using 



the utility valid option mask table 



OCP - OPTION COMBINATION PROCESSOR 

OCP validates combinations of utility options COP) to 
that conflicting options have not been specified. 



insure 



PIE - PROCESS INITIAL ENTRY 

PIE processes the arguments entered when selecting which 
utility will be used via the K display. PIE calls VO set 
valid options) to format the individual utility K display. 

SVO - SET VALID OPTIONS 

SVO sets list options, utility options and parameter values 

that are valid for the particular utility on the left screen 

" s y forVh°e utili?y. SVO uses the utility valid option 
mask table to indicate what options are available for the 
utility. 

• PFU - PF UTILITY PROCESSOR 

PFU performs a variety of utility functions for the permanent 
file utilities. Functions are provided for ■■naging t he 

of permanent file system activity CPFNL), the 




ut i li t i es . 

Common deck COMSPFU provides for the definition of func *;° n 
codes? FET equivalences, and a CPU program macro for calling 

PFU. 

Also in COMSPFU, the format of the archive tape label < thi s 
Sescr bes the data, not the tape) and the archive tape control 
word are defined. These formats are described under Writing 
an Archive File in the PFDUMP subsection. 
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The following is a list of PFU function codes. 



Symbol 



Value 



CTOP 


000 


CTOL 


100 


CTAC 


200 


CTRL 


300 


CTLM 


400 


CTSU 


500 


CTCU 


600 


CTRC 


700 


CTCF 


1000 


CTFL 


1100 


CTSC 


1200 


CTCC 


1300 


CTEI 


1400 


CTCT 


1500 


CTIA 


1600 


CTDA 


1700 



Def i ni t ion 

Open file no lockout 
Open file with write lockout 
Advance catalog track 
Read data list (PFDUMP) 
Load main loop (PFLOAO) 
Set PF utility interlock 
Clear PF utility interlock 
Rewind catalog file 

Change f i le name 
Set f i le length 
Set catalog track interlock 
Clear catalog track interlock 
Set error idle status 
Locate catalog track 
Increment PF activity count 
Decrement PF activity count 



CTTU 



2000 



Test PF utility interlock 
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Table 36-2 illustrates which functions are used by each PF 
utility (PFATC does not do any PFU activity). Figure 36-3 



illustrates the PF utility FET 



TABLE 36-2. PFU FUNCTION USAGE 



Function 



CTOP 



CTOL 
CTAC 



CTRL 
CTLM 



CTSU 
CTCU 



CTRC 
CTCF 



C T F L 
CTSC 



CTCC 
CTEI 



CTCT 
C T I A 



CTDA 
CTTU 



PFCAT 



PFCOPY 



PF Ut i li ty 

PFDUMP I PFLOAD 
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FET +0 



+ 1 



+2 



+ 3 



+ 4 



+ 5 



+ 6 



+ 7 



+ 10B 



+ 11B 




logical file name 






/ 




sector count/recall word 



data word for PFDUMP read list 



data list/catalog address 



parameter word 




FIRST 



IN 



OUT 



Z 



FTLM 



FTRE, FTSC 
FTDW 

FTDL, FTCA 
FTPM 



Figure 36-3. PF Utility FET 
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PFU STRUCTURE 

PFU consists of function processors for each of the PFU 
functions plus a group of common subroutines. 

Upon entry to PFU, a preset routine (PRS) is called. PRS 
validates the FET address to be within the program's field 




and CFS (complete FET status). The PP is then dropped via a 
DPPM monitor function and control is returned to PPK 

PFU major subroutines include the following. 



CAU 



- CLEAR PFU ACTIVE FLAG 



kept in the 



CAU clears the PF util ity .active flag that is 
utility's field length. The address of the PFU active flag 
supplied when the flag is set and the address is saved in 
locations PFAF through PFAF+1 . 



i s 



CCA - CHECK CENTRAL ADDRESS 



VADDR validates an 



CCA is called as part of the VADDR macro. 

address that is right- or left- just if ied within two adjacent PP 

loc ions. "CCA gets the address and ca I Is^subrout ■ me 
VGA (validate central address) to validate the address. CCA 
aborts with the following diagnostic if the validation 
successful. 

PFU - PARAMETER ERROR. 



i s not 



CFA - COMPUTE FET ADDRESS 



FETA macro. CFA returns the 



CFA is called as part of the .,„„.,, 

absolute address of the FET word from a supplied word number, 
the FET address (IR + 3 through IR+4), and RA. 



CFS - COMPLETE FET STATUS 



CFS sets the completion bit (bit zero in word zero of the FET) 
and clears the FET address from the input register (IR+3 
through IR+4). 
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DCH- - DROP CHANNEL IF RESERVED 

DCH. examines the channel flag (CF) and drops the channel CT4) 
if CF is nonzero. CF is cleared before returning to the caller 



FAR - FORCE AUTORECALL 

FAR calls CRS (COMPCRS - check autorecall status) and aborts 
with the following diagnostic if PFU is called without 
autorecal I. 

PFU - PARAMETER ERROR. 



FFE - FIND FNT ENTRY 

FFE is called to find the FNT entry of the file name specified 
in the FET. FFE is called with two options: make LIFT check, 
and abort if file not found. If the file name in the FET 
agrees with the name in the FNT at the address specified in FET 
word FTLM, the FNT search is by-passed. If the file names do 
not agree, the FNT is searched for a match. If no match occurs 
and abort on error is selected, the following diagnostic is 
issued and PFU is aborted. If no abort is selected, the exit 
address is advanced by one and control transferred to that 
address. 

PFU - FILE NOT FOUND. 

When an FNT entry with the correct file name is found, the 
library type check is done if selected. If the file found is 
not a library file, the condition is treated as if a match did 
not occur. If the library condition is satisfied, the FNT 
address is entered in FET word FTLM, and the file is set busy 
via the STBM monitor function. The FST is read and control is 
returned to the caller if the file is successfully set busy. 
If the file is not set busy, the following diagnostic is issued 
and PFU is aborted. 

PFU - I/O SEQUENCE ERROR ON filenam AT addr. 
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DB - LOAD BUFFER 



LOB transfers a PRU of data 
in the uti lity's field Length 
FET buffer 



from mass storage to a FET buffer 
Data is transferred until the 

file 



* i. „ 4. - i 4.u anri-of -information for the 
ppt h uffer is full or until the ena 01 ,■ " .,-■-. .. . „a*a 
p t I DUTTer i. > i " ^„u~a Parh bLock of data is preceded 

being transferred is reached. Each dlock 
by a control word in the following format. 




35 



23 



current sector 



mass storage linkage 



ec ' Error code: 

No error 

1 File too long; linkage set to EOI 

2 Nonfatal mass storage error 

3 Fatal mass storage error; linkage set to 



EOI 



PAR - PAUSE AND RESET ADDRESSES 



PAR does a PAUSE and 

need to be changed due to a 



then checks to see if absolute addresses 
in the uti Li ties RA. 



change 



- PROCESS DIRECT ACCESS FILE 



PDA 

PDA determines if the direct access file (DAF) being Processed 
resides on the master device being processed. .If.it does not, 

e master device channel is released and mass st orage 
processing is set up for the DAF device. If the DAF device is 

C Ud member of the family, the fo Uoj 1 ng di agnos t,c s 
issued and PFU is aborted. PDA sets the DAF flag (DA) prior t, 



returning to its caller. 

ALTERNATE DEVICE NOT FOUND 



RCH. - REQUEST CHANNEL IF NOT RESERVED 

RCH. checks the channel flag CCF) and if it .is not set, 
requests the channel specified in T4. The channel flag i 



s set 



before returning to the caller. 



RPP - RECALL PP 



RPP takes the PP call word contained in direct ceLLsIR through 
IR^4 converts it to an RA + 1 call with aut or eca 1 1 w r 1 1 es it to 
raIi', drops the PP via a DPPM monitor function, and then 



transfers control to PPR. 
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SAP - SET ADDRESSES FOR DUMP AND LOAD 

SAP presets instructions with absolute FET buffer address for 
data transfers between the FET buffer and PFU's buffer. 



SAU - SET PFU ACTIVE FLAG 

SAU sets a PF utility active flag at a specified address within 

the utility's field length. The address of this flag is saved 

internally to PFU so that the flag may be cleared by CAU before 
PFU is dropped. 



SBA - SET BUFFER ARGUMENTS 

SBA reads FIRST, IN, OUT, and LIMIT from the FET into direct 

cells FT through FT+1 , IN through IN + 1, OT through OT+1 , and LM 
through LM+1 . 



SCT - SET CATALOG TRACK 

SCT reads the permanent file descriptor word and user index 
from the utility. The catalog track for the user index is 
determined via a call to subroutine SCA (COMPSCA - set catalog 
address). If the catalog track cannot be found, the following 
diagnostic is issued and PFU is aborted. 

PFU - CATALOG TRACK NOT FOUND. 



SFC - SET FILE COMPLETE 

SFC sets the file not busy bit in the FST for the file. FA is 
cleared on return to the caller. 



SFF - STORE FILE NAME AND FET ADDRESS 

SFF completes the diagnostic message which is of the form: 

f i lenam AT addr . 
by supplying the file name and address. 

SFT - SET FILE TYPE 

SFT sets the file type and mode in the FNT entry for the 
specified file. 

SOC - STORE ONE CHARACTER 

SOC stores one display code character at the position specified 
in the call. 
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STS - STORE STRING 

STS stores up to three characters a 
the c a L I . 



t the position specified in 



UFP - UPDATE FET POINTERS 

UFP writes the IN pointer from direct "Us to the FET and 
reads the OUT pointer from the FET to its direct cells. 

VGA - VALIDATE CENTRAL ADDRESS 

VGA verifies that a central memory address falls within the 
control point's field length. 

VME - VALIDATE MASS STORAGE EQUIPMENT 

VME checks that a specified equipment is a mass sto jage device - 
If not, the following diagnostic is issued and PFU is aborted. 

PFU - PARAMETER ERROR. 

WIF - WRITE INTERLOCK FLAG 

WIF sets/clears an interlock flag in the utility's field length 



PFU COMMON DECKS 

PFU also uses the following common decks as common subroutines 



Common Deck 

COMPCRA 

COMPCRS 

COMPCII 

COMPCUT 

COMPRSS 

COMPSCA 

COMPSDN 

COMPSEI 

COMPSNT 

COMPSRA 

COMPSTI 

COMPSUT 

COMPIRA 



Desc r i pt i on 

Convert random address 

Check recall status 

Clear track interlock 

Clear permanent f i le utility interlock 

Read system sector 

Set catalog address 

Search for device number 

Search for end-of -i nf o rma t i on 

Set next track 

Set random address 

Set track interlock 

Set permanent fi le utility interlock 

Initialize random access processors 
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The following subsections describe the PFU functions. 

OPN - OPEN FILE 

The open file (OPN) function includes the following options. 
Function Symbol Desc ript i on 



00 
01 



CTOP 
CTOL 



No write lockout 
With write lockout 



Upon entry to OPN, FET+0 and FET+FTPM must have the following 
format. 



FET+O 



+ FTPM 




f st FST for f i le 

Upon exit from OPN, FET+1 and FET+FTLM have the following 
format . 



59 



FET + 1 



+ FTLM 



en 



fa 



47 



unchanged 



unchanged 



en Equipment mnemonic 
fa FNT address of f i le 

OPN makes an FNT/FST entry for the specified file, makes it 

library type (LIFT), and uses the FST entry passed in the FET 

for the file's FST. The write lockout bit (bit 12) is set in 

the FNT for the CTOL function. The equipment mnemonic and FNT 

address are set into the FET before returning to the utility. 
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ACF " ADVANCE CATALOG FILE 

The ACF function, CTAC (02), advances the position of the 
catalog file to the next track in the chain and advances the 
catalog interlock if set. 



Upon entry 



to ACF, FET+0 must have the following format 



59 



FET 



file name 




ACF advances to the next catalog track by a call to subroutine 
SNT CCOMPSNT -- set next track) which returns the next track in 
the catalog chain. If the previous catalog track had been 
interlocked (bit 9 of FST is set), then the previous catalog 
track interlock is released by a call to subroutine CTI 
(COMPCTI - clear track interlock) and the new track is 
interlocked by a call to subroutine STI (COMPSTI - set track 
interlock). The file is then set to begin reading the new 
catalog track. 

RRD - READ DATA LIST 

RRD, function CTRL (03), reads a list of files from disk to a 
CM buffer. 
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Upon entry, the following FET words must be formatted as shown 



59 



FET+O 



47 



35 



23 17 11 







+ FTRE 



+FTOL 



+ FTPM 



data file name 


'WM^. 


rf 


me 


ad 


rl 


dl 


MM^M 


ec 


4000+dn 


fe 


Im 



rf 



me 
ad 
rl 
dl 
ec 
dn 
fe 
Lm 



Reca L I f Lag : 

Not recall call (zero word) 

7777 RA+1 recall call 
Master equipment number 
Alternate device number 
Remaining file length 
Data list address 
Element count of data list 
Device number 
Fami ly equi pment 
List modification date and time 



RRD is the primary function used in permanent file dumping 

PFDUMP builds a data list buffer in its field length which 

indicates the file(s) to be dumped. The data list buffer 
entries have the following format. 



59 


47 




23 




11 







2000B + ci 


If 


tk 


sc 



ci Catalog index into catalog buffer 
If Length of file (indirect access only) 
tk First track of file 

sc First sector for indirect access files; 
1 /1 ,1 /f, 4/0,6/ rd for direct access files 
f for normal processing; 

1 for forced dump (no date checking) 
rd Residency device number 

RRD works through the data list dumping (copying the file data 
to the DATA FET buffer) each file encountered. 
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. _,. 4. .^o«ec fiips the FST for the DATA file is built 
F °- '"Ilia sector specified in the data List entry. 
FnrVrect access files, the DATA file FST is built, with the 
For direct ac cess ii i« , orma tion in the data List entry 
equipment number and track ^° rm \ u t0 css (check system 
The svstem sector is vauaaiea u/ a 
sector) to verify that the file may be dumped. 



The 
a ca 
a ch 
the 
PFU 
or t 
reca 
wo rd 
avai 
buff 
ac ce 
the 



data 
U to 
eck i 
EOI h 
shou L 
he f i 
I I wo 
is s 
table 
er f i 
ss f i 
rema i 



is tr 

LDB 
s mad 
ad no 
d con 
le be 
rd is 
et in 

(arc 
I li ng 
le, R 
ning 



ansf e 
( load 
e to 
t bee 
t i nue 
i ng d 

set 
to FE 
h i ve 
) o r 
RD pa 
read, 



r red 

buff 
deter 
n pro 
t ran 
umped 
i nto 
T wo r 
tape 
the f 
uses 
and 



f rom 
er ) . 
mi ne 
cess 
sf er 

i s 
FET 
d FT 
can 
i le 
by a 
call 



mass 
When 

if th 
ed, a 
ring d 
a larg 
word F 
DL and 
be w ri 
bei ng 

call 
s LDB 



stor 
con 
e EO 
chec 
at a . 
e di 
TRE 

PFU 
1 1 en 
dump 
to P 
to c 



age to the FET buffer by 
trol is returned from LDB, 
I had been processed. If 
k is made to determine if 
If no PPs are available 
rect access file, the 
and the data list control 
drops. If PPs were 
simultaneously with 
ed is a long direct 
AR, sets the length for 
ontinue reading. 



if an EOI had been processed, dumping proceeds with the next 

em n ent°in ha the data'list. Before continuing however dt 
access file pointers are cleared and if a di rect acces ti 
w^sbling dumped, master device poi nters are res or d f he 
file was not on the master device) and fast atta n contru 
updated (by a call to RRF - return fast attach file) if the 
f i le was a FAFT file. 

« ^,» + a Net items the data list word is 

T ± there are no more data List items., «-nc ^ « u « i « „ _ ~ ,4 

cleared from the FET (word FTDw) , the sector number is cleared 

in the DATA file FST and PFU is dropped. 

If RRD had been entered with a recall condition ( "T «ord FTRE 
set), the working direct cells are restored from FTRE and the 
data transfer activity is resumed. 

RRD uses a collection of subroutines that are primarily 
associated with direct access file dumping. 

Subroutine CSS (check system sector) is "^ "/l^^ ^ 
direct access file's system sector. If the system sector 
clnnot be read, a bad system sector status is returned. 

Once the system sector has been read, it is Recked to 
determine if the file can be dumped. Subroutine CDS UHea 

status) first determines if the file is a fast attach file 
tntif so calls subroutine FAF (fast attach file) to interlock 
and if so cau» suur h fNT f the fUe and if 

1 7 t^lX's ,*„ reao allow modify mode and sets the user 
c ount'u a sing Ch tre PTRm, AFAS . opti ons on the I»U- an< JIUC, option 
on the .STB* "0"^" function. If he I •;»««« * » •* «,/, 
p rrma h n e e d nt, S read U rilow S :odif S y C file and CDS returns to CSS with 
the dump file status set to dump the file. 
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If the file is not a fast attach file or is not found in the FNT 
as fast attach, the file's mode is checked (FCCA in the system 
sector) and if the file is in write mode, that status is 
returned to CSS. 

If the file is attached in modify or extend mode, the DATA file 
is set as a read allow modify library file by a call to SFT and 
CDS returns to CSS with the dump status set to dump the file. 

If the file is not attached in any mode allowing writing, the 
DATA file is set as a read mode library file by a call to SFT. 
If the force dump flag is set, the dump file status is set to 
dump the file. Otherwise, the modification date is checked by 
subroutine CMD (check modification date) and that result is 
returned to CSS by CDS. 

Once CSS resumes control, it sets the file length (by a call to 
subroutine SEI (COMPSEI - search for end-of-i nf o rma t i on) , sets 
the working length by a call to subroutine SDL (set direct 
length), set first track and sector pointers, writes a control 
word having the following format into the FET buffer, and 
advances the IN pointer. CSS then returns to RRD with the dump 
st atus . 



59 


47 


23 


st 


If 


lb 



st 



Fi le Status : 



Dump file 

1 File in write mode 

2 Zero length file (no EOI) 
4 Bad system sector 

10 File does not meet modification date and time 
criteria 

If Length of file (includes EOI) 

lb System sector linkage bytes 



Subroutine RFF (return fast attach file) is used to return the 
fast attack file after dumping. RFF returns the file using a 
call to OFA and then resets the DATA file entry to a read mode 
library file by a call to SFT. 

Subroutine SDL (set direct access file length) is used to 
determine the amount of the file to dump (transfer) at one time 
The amount transferred in one LDB call is limited to the field 
length of the utility. 
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LML - LOAD MAIN LOOP 

Function 4, LML, p recesses C ATS , PETS j, and 
entry, FET & FTPM has the following format. 



and DATA files. Upon 



59 



53 



35 



17 



FET+FTPM 



dn 



data 



pets 



pafl 



dn Master device number 

data Address of DATA file FET (0 if no DATA FET) 

pft Address of permits file FET (0 if no peril s FET) 

PFU active flag address; set to one when the PFU 
P Load processor is activated and set to zero when th< 

PFU Load processor completes or aborts. 

over Lay . 

LML processes functions on each of the three utility files: 
cats! PETS, and DATA. These functions are passed jn byte 
the first Cord in each FET. The functions are as follows 

Description 

Pos i t ion file 

Wri te f i le 

Read file (fill CATS buffer) 

Completion of load 



Function 




2 

4 

10 



The main loop of loading (LML) performs the following functions. 

. Checks for functions on CATS and performs the function 
desi red . 

• Checks for functions on PETS and performs the desired 
function. 

• Checks for functions on DATA and performs the desired 
function. 

• Checks for termination (termination function on CATS) and if 
termination is not desired goes through the loop again. 

When the termination function is set, the utility active flag 
is cleared and PFU exits. 
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The function processors are as follows. 



Funct ion 

PCF 
PCW 
PCR 
PPF 
PPW 
PDF 
PDW 



Description 

Position catalog file 
Process catalog write 
Process catalog read 
Position permit file 
Process permit write 
Pos i t ion data f i le 
Process data write 



The load sequence begins with a call to subroutine PLL (preset 
load loop). PLL reads the loading control word from FET word 
FTPM. PLL sets the PF utility active flag by a call to 
subroutine SAU. The device number, CATS FET address (from IR+3 
through IR+4), PETS FET address, and DATA FET address are set 
into direct cells. The CATS FET is set complete by a call to 
CFS. If the PETS and DATA addresses are present, they are 
validated by a VADDR request. The DATA address is then moved 
to the input register IR+3 through IR+4, the files positioned 
by a call to subroutine POF, the DATA FET completed by a call to 
subroutine CFS, and control returned to the main loop. 

Subroutine POF (position files) works with the DATA and PETS 
files. POF relies on the following information to be passed to 
PFU in the DATA FET 

59 47 35 23 17 11 



FET+FTDW 



+ FTDL 



1 


W, 




Wtffl, 


w 


fe 


nf 


St 


eq 


ft 


tk 


sc 



fe Equipment number of a family device 

nf Noninitial load flag (zero to check that indirect 

access file chain is empty, nonzero to bypass check) 
st Status: 

If beginning of file 

1 If middle of indirect access file 
3 If middle of direct access file 

eq Master equipment number if middle of direct access 

f i le 
ft First track of indirect access file chain if middle 

of direct access file 
tk Current track of indirect access file chain if 

middle of direct access file 
sc Current sector of indirect access file chain if 

middle of direct access file 

After validating the DATA FNT/FST entry, POF finds the EOI for 
the DATA file by a call to SEI. If processing an indirect 
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access. file the NF value ^o. FTDW 1. ch.e k-d *- d.t »•<%,?• 
c^^u^L^P^o^^s-He ».U..1n, ^.nostic is 
i s sued and 



PFU is aborted. 



DEVICE NOT INITIALIZED. 




FET+FTSC 



59 



47 



sector count 







unchanged 



The 
the 



PETS file is then 
caller (PLL) . 



set complete and control is returned to 

loop, processi ng 



Load processing now continues its main Loop, P™"""' 
functions identified in the CATS, PETS, and DATA FETs. 



are performed by subroutine call 
11 to subroutine PIO (preset I/O) 



Most functions 

begi n with a ca 

with a call to CIO (complete I/O). 



Subroutine PIO sets up 



sequences that 
and terminate 



direct cells for reading or writing 
^aHd^ing ^e m. FNT/FST, initializing random addresses 
(subrou ine IRA), setting buffer addresses 'subroutine SBA 
SAP), and clearing the sector count in subroutine SSC. 



by 
and 
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CATS Position 

Subroutine PCF 
of the catalog 
subroutine SCT 
specified user 
and the current 



(position catalog file) performs the positioning 
file. Word FTCA is read from the CATS FET and 
is called to identify the catalog track for the 
number. The current sector position is cleared 
sector count cleared in subroutine SSC. The 



FTCA word has the following format. 



FET+FTCA 



59 



35 



17 



^ 


77777// 


'Wfa 


pfd 


aui 



pfd Address of permanent file descriptor word 
aui Address of user index word 



CATS Write 

Subroutine PCW (Process Catalog Write) calls subroutine SSC to 
get the count of the number, of sectors remaining to be written. 
If no sectors remain, the sector counter in SSCT for the CATS 
file is cleared and PCW returns to the caller. 

If sectors remain, the control word is read from the FET buffer 
by a call to RCW (read control word). Subroutine PCA (process 
CATS addressing) is called to set the track (T6) and sector (T7) 
pointers from the control word. 



59 53 



47 



35 



23 



t, , 


r 


tk 


sc 


linkage 



ty 



2 if EOI 
1 if EOF 
if EOR 



or full sector 



Rewri te: 

Normal 

1 Rewrite 



i n place 



tk If nonzero, tk and sc are the random position 
for the catalog file; otherwise the current 
position is used 
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The channel is reser 
buffer to mass storage by 



st oriage 
he 
e 



■ ^ i_ j~+.n transferred from the FET 
ved and the data an ter ufferK Dat 
n* hv subroutine E M 8 *. e m p «■ 7 

;: f i;;«rf.:"2 :nrir 9 :h b /«oi h.. b,. n r..ch.- or . .... .to« 

r oiB ;:r?: t :r..:.3!s^:\^ t «--" 1 - 1 ' 



ca L Ler 



At end-of-i nf o rmat i 
called, the sector 
returned to the caller. 



CATS Read 



lodifies the UDB 

reserves the 



chrnutine PCR (process catalog read) modif 

.^uln'. "'bypass f,..l« . l.n.th count n. ^ ^ 

?r e F HT o^^"^^^^ ttYh.n r.l...... and control 1- 



ch 
CA 



returned to the caller. 




eturns to the caller 




PETS Position 



permit 



file) reads the FTPM word from 




PFU - PARAMETER ERROR. 
The format of FTPM is as follows. 



FET+FTPM 
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PETS Write 

Subroutine PPW (process permit write) calls subroutine SSC to 
determine if there is data available in the FET buffer. If 
none is available, PPW returns to the caller. If data is 
present, the channel is reserved and the permit data 
transferred by a call to subroutine EMB (empty buffer). PPW 
loops on calls to EMB until the buffer is empty or a mass 
storage error occurs. 

If an error occurs, the channel is released and subroutine STE 
is called to set an EOI in the TRT. PPW returns to the caller 
upon return from STE. 

When all permit data has been written, PPW checks the beginning 
of files table for PETS (BEGF) and determines if an EOI has 
already been written. If not, subroutine WEI is called to 
write one. PPW then releases the channel, sets the EOI in the 
TRT by a call to STE, and returns to the main loop. 



DATA Position 

Subroutine PDF (position data file) checks the direct access 
flag (DA, set by POF) and, if set calls subroutine EDF (end 
direct access file) to restore master device controls in DSLA 
and reset the DATA FST to point to the current indirect chain 
mass storage position. EDF clears DA before returning. 

PDF then sets the beginning of file flag in BEGF and reads the 
FTPM work from the DATA FET. This word has the following 
format. 



FET+FTPM 



59 



35 



23 



11 



'W%%. 


w, 


tf 


tk 1 


f pm 



if track and sector position request: 



tf 
tk 
pm 



Ignored 

Track 

Sector 



File is positioned to the sector preceding the tk/pm 
location 

1 if drop and flaw track request: 

tf if no track to flaw or track to flaw 

(if nonzero) 
tk First track to be dropped 
pm Equipment (lower 6 bits). 

Track chain is dropped and track is optionally flawed 
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for 



track and sector positioning, PDF calls 




loop . 

If the request 



lt tne requesu is for a drop and flaw track request, PDF calls 
^bro^me^T (drop and ".»*'"» ^J^^Vtll ed "" 
^^^^)Z^^.^ .?? to set the tr.c. 
flaw. The following diagnostic is issued if the tracK 



successfully flawed. 



PFU - TRACK FLAWED, EQxx, Tyyyy 

Subrout i ne SDS i s 

ca I led 

caller. 



me »u» i. called by PDF to clear FTOL subroutine CIO is 
called to complete the operation, and control is returned to the 



DATA Write 




f o I lows . 

Subrout i ne 
to be a 



BDF (begin direct access file) is called if the file 
direct access file. Subroutine BDF begins by 



reading the file name from the catalog entry at ^.e address 
passed through the control word. Master device mass storage 
parameters are saved in DSLA as follows. 



DSLA 



59 



47 



35 



23 



11 







md 



T5 



FS+1 



T6 



T7 



md Master device number 

T5 Master device equipment 

FS + 1 Fi rst track 

T6 Current track 



T7 



Cur rent sector 
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BDF then calls subroutine PDA (process direct access file) 
which completed DSLA by setting the master device (MD), 
initializes mass storage parameters for the residency device, 
and sets the direct access flag (DA). Subroutine BDF then 
calls subroutine RTK (request tracks) to obtain a track chain 
for the f i le. 

Subroutine BDF builds the system sector for the direct access 
file, sets the preserved file status (SPFS subfunction to STBM) 
reserves the channel and writes the system sector. BDF then 
resets central memory addresses using a call to subroutine SAP, 
if necessary, writes the DATA file FST entry, and returns to 
subroutine PBF. 

Subroutine BIF (begin indirect access file) is called if the 
file is an indirect access file. Subroutine BIF increments the 
current sector and if not at the track sector limit returns to 
subroutine PBF. If sector limit is reached, subroutine SNT is 
called to move to the next track. If there is not a next track, 
subroutine RTK is called to reserve more tracks. When the 
tracks have been obtained, control returns to PBF. 

Having begun the direct or indirect file, subroutine PBF calls 
subroutine RBA (return beginning address) which writes the 
beginning track and sector information into the catalog entry 
in PFLOAD's field length. Subroutine PBF then clears the begin 
file flag (BEGF) and returns to subroutine PDW. 



Upon r 
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ubro 
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lag 
EOI 
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call 
sed, 
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om t 



ut i ne 

o t ran 
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ten an 

is c h e 

has n 
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and s 
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If an 
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PDW r 
sf er 
h ree 
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eked 
ot be 
el is 
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ases 
f er u 



eserve 
the da 
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Subroutine PEF (process end of file) is called to end the 
current file base depending upon what the next file is. If 
both the current file and the next are indirect access, 
subroutine PEF returns to the caller. If either file is a 
direct, subroutine STE is called to set an EOI in the TRT. If 
the current file is a direct, subroutine EDP is called to 
restore the DATA file FST to reflect the indirect chain 
pointers, clear the direct access flag (DA), and reset master 
device controls from DSLA. 
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The following decision table shows subroutine PEF operation 




After subroutine PEF has ended the file, 
process beginning of file step again. 



PDW 



proceeds from the 



EMB - Emoty Buffer 

*• * pmr transfers data from the FET buffer in the 
V^Z Tfi^englHnd -r,t.. th.t data or ,.... ..tor.,.. 

S p;r S %rd b ^) n nT U s;%r:»e wh W arrep:nd e nt upon the file 
being w^Utenand th. control word associated with it. 



After the da 
EMB advances 
next sector 
the file its 
manner as ot 
processed, t 
ope ration ( b 
not 2), subr 
EOI) to writ 
(process cat 
the catalog 
to write on 



ta has 
T7 (c 
i s the 
elf. 
her ma 
he con 
yt e 0) 
out i ne 
e an E 
a log I 
ove rf I 
the ov 



been 
ur rent 
t rack 
C a t a I o 
s s sto 
t ro I w 
. If 

EMB c 
01 sec 
i nkage 
ow t ra 
erf low 



read from central memory, subroutine 
sector) to the next sector. If the 
sector limit, processing depends upon 
q tracks are not linked in the same 
rage tracks. If the CATS file is being 
ord is checked for the type of 
the operation is not an EOI (operation 
alls subroutine PCE (process catalog 
tor if necessary; subroutine PCL 
) to identify (create, if necessary) 
ck; requests the channel; and positions 
t rack . 



If the track overflow occurs when an EOI is being written, 

subroutine EMB writes the EOI and continues. 

If the current -rlt. 1. not »„ t.J « t . ; ,, le <„„. ; t 1 1 1 at 

.::^.ol:r , u;iS B b .°c t .U , to ,, S H d Tr:n- , obt.1n. a track chain if 

necessary. 

Subroutine EMB now continues bui ^ing track lin kage by t es 

based on the next track, sector, and the type ot uu 

Qnecified in the control word. i i +« upt is 

The sector is then written to mass storage (a call to WEI is 

done if writing an EOI). If the utility program has moved (RA 
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changed), subroutine SAP is called to reset absolute buffer 
address to reflect the new RA. Subroutine EMB then advances to 
the next sector or sets the BEGF flag to 1, depending upon the 
linkage bytes for the sector. 

Subroutine EMB now decides to continue or exit. If there are 
no sectors left to transfer, subroutine SSC is called to 
determine if more sectors are present in the buffer. If no 
sectors are present, subroutine EMB returns to the caller with 
an empty buffer status. If sectors are present, BEGF is 
interrogated and if nonzero, subroutine EMB returns to the 
caller with that status. This indicates that an EOI was 
written but the buffer is not empty. If BEGF is still zero, 
subroutine EMB loops to read the next block of data from 
central memory. 

The final exit condition is for write errors. All write 
operations are done with MSEO user error processing CUERP) 
selected. This allows subroutine EMB to regain control on 
write errors. Subroutine PWE (process write errors) is called 
if an error occurs. Subroutine PWE sets the write error code 
(FTWE=1) into the first word of the FET (bits 17 through 12) 
and rewrites that word. The EOI flag is set in BEGF (that is, 
BEGF=1), the FST entry of the file (with the current track and 
sector updated) is written to the FET at word FTPM and the 
sector counter (SSCT) for the file is set to reflect the amount 
of data in the buffer. Subroutine EMB then returns to the 
caller with write error status set. 



STU - SET PF UTILITY INTERLOCK 

Function 05 (CTSU) sets permanent file utility interlocks. 
Upon entry, FET + FTPM has the following format. 



FET+FTPM 




eq Equipment to set utility interlock on 
intf Interlock flag address; set to one when the 
PF utility interlock is set; set to two if 
PFU has to go on recall to wait for no PF 
activity 

STU attempts to set the permanent file utility interlock for 
the equipment specified. STU uses subroutine FAR (force auto 
recall) to ensure that PFU is called with autorecall. This is 
done so that PFU may reissue the STU request to RA+1 if the 
attempt to set the utility interlock fails. If PFU is not called 
with autorecall the following diagnostic is issued and PFU is 
aborted. 



PFU 



PARAMETER ERROR. 
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set and to clear it should an abort occur 




out all new perma 
time. 



CLU - CLEAR PF UTILITY INTERLOCK 

r.U function 06 <CTCU>, is used to clear the interlock set by 
STU: Upon entry, FET + FTPM has the follownng format. 

59 " " 17 ° 

FET+FTPM v// 




eq Equipment to clear .utility interlock on 

intf interlock flag address; i f t hi s word is equa to 

one the utility interlock is cleared, otherwise the 

request for PF system interlock will be cleared; 

the word is set to zero when one of the interlocks 

i s c leared 

If the interlock word is 1, CLu clears the i "terloek by a call 

l. 4.- ~ put fripar utility interlock). Otherwise, tne 

subroutine ri« vh« . .__, ftrk ) PIR i s part of common deck 

( r- I o a r rpnnest for intePLOCK^ . r X r\ ia K a « «• 

Cclear request tui . interlock flag word is cleared by 
COMPSUT. In all cases the interiocK tu 9 

call to WIF. 



to 
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RCF - REWIND CATALOG FILE 

Function 07 (CTRC) rewinds catalog files. Upon entry FET+0 is 
formatted as follows. 



FET+O 



59 


17 


file name 


^MH 



This function is used rather than a CIO rewind since the 
catalog file (CATS) does not have system sectors (that is, 
catalog data begins in sector zero). The current sector is set 
to and current track is set to the first track in the FST. 



CHF - CHANGE FILE NAME 



Function 10 (CTCF) changes the file name, 
and FET+FTDL are formatted as follows. 



Upon entry, FET+0 



59 



FET+O 



+ FTDL 



old file name 



new file name 



17 




CHF finds the old file name in the FNT, replaces the file name 
with the new file name, and replaces the old file name with the 
new file name in the FET. 

If the file is not found, one is created. 
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SFL - SET FILE LENGTH 

Function 11 ( CTFL) de te rmi nes the length of a file 
FET+0 and FET+FTPM have the following format. 



Upon entry, 



59 .53 47 



FET+O 



+ FTPM 




eq Equipment file resides on 

tk First track of file; if zero the first track is 
taken from the FST for the file 

Upon exit, FET+FTPM has the following format. 



59 



Zh 



FET+FTPM 



unchanged 







file length 



SFL finds the file in the FNT. If TK is not specified, the 

first track field of the FST is used. The equipment forthe 

file is verified to ensure that it is a mass storage device. IT 

it is not mass storage, the following diagnostic is issued and 
P FU is aborted . 

PFU - PARAMETER ERROR. 

If not aborted, SFL then calls subroutine SEI (COMPSEI - search 
for end of information) and returns the length of the file from 

the track specified to the EOI. 

SEC - SET CATALOG TRACK INTERLOCK 

Function 12 (CTSC) sets the catalog track interlock. Upon 
entry, FET+0 contains the file name, lef t- j us t i f i ed . 

SEC finds the file in the FNT and ensures that the equipment for 
the file is mass storage. If it is not mass storage, the 
following diagnostic is issued and PFU is aborted. 

PFU - PARAMETER ERROR. 
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If bit 9 is set in the FST entry, the track is already 
interlocked and PFU aborts with the following diagnostic. 

PFU - TRACK INTERLOCK ALREADY SET ON filenam AT address. 

If the track is not interlocked for the file, SEC calls 
subroutine STI (CQMPSTI - set track interlock) to set the track 
interlock. If successful, bit 9 is set in the FST. If the 
interlock was not set, PFU is aborted with the following 
di agnost i c . 

PFU ABORTED. 



CLC - CLEAR CATALOG TRACK INTERLOCK 

Function 13 (CTCC) is used to clear the interlock set by SEC. 
Upon entry, FET+0 contains the file name, lef t- j ust i f i ed. The 
equipment and first track of the file define the track to clear 
the i nter lock on. 

CLC finds the file in the FNT and ensures that the equipment for 
the file is mass storage. If it is not mass storage, the 
following diagnostic is issued and PFU is aborted. 

PFU - PARAMETER ERROR. 

If bit 9 in the FST is not set, PFU aborts with the following 
di agnost i c . 

PFU - TRACK INTERLOCK ALREADY CLEAR ON filenam AT addr. 

Otherwise the interlock is cleared by a call to common deck 
COMPCTI. The interlock bit in the FST (bit 9) is also cleared. 



SES - SET ERROR IDLE STATUS 

Function 14 (CTBI) sets error idle status. Upon entry, FET+0 
has the following format. 



FET+O 




eq 



Equipment to set error idle status on 



SES sets the error idle bit in the MST using the SGBS 
subfunction of the STBM monitor function. 
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LCT - LOCATE CATALOG TRACK 

Function 15 (CTCT) Locates the catalog track. Upon entry, FET ♦ 





FTPM has the following format 



FET+FTPM 




QUI 



pfd 
aui 



Address of permanent file description word 
Address of user index word 



Upon ex 



it, FET+FTPM has the following format. 



59 



17 



FET + FTPM 



eq 



11 



ct 



eq Equipment number of master device 
ct Catalog track of user 



LCT makes a call to subroutine SCT, which returns the equipment 

and catalog track for the given user index. 

The format of the Pe rmanent \ F jle Desc r i pt 1 on > rd is as follows 



PFD 

pn 
eq 




Pack name if upper byte is nonzero; otherwise 

Equipment number of any family member if upper 
byte of pack name i s zero; otherwi se ignored 
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IAC - INCREMENT PF ACTIVITY COUNT 

Function 16 (CTIA) increments the permanent file activity count 
Upon entry, FET+FTPM has the following format. 



FET+FTPM 



59 






17 







w, 


y SW4^ / 


/ ////Ay///y 


intf 



intf Interlock flag address; this word is set to one 
when the PF activity count is incremented. 

IAC verifies that PFU has been called with autorecall by a call 
to subrout i ne F AR . 

IAC requests that the permanent file activity count be 
incremented by using the IPAS option to subroutine PIR. If the 
interlock is not obtained, PFU goes on recall using a call to 
RPP. 

If the interlock was obtained, the interlock flag is set using 
a call to subroutine WIF. 



DAC - DECREMENT PF ACTIVITY COUNT 

Function 17 (CTDA) is used to decrement the activity count set 
by IAC. Upon entry, FET+FTPM has the following format. 



FET+FTPM 




intf Interlock flag address; this word is set to zero 
when the PF activity count is decremented 

DAC requests that the permanent file activity count be 
decremented using the DPAS option to subroutine . PIR. The 
interlock flag is then cleared using a call to subroutine WIF 
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TSU - TEST PFU INTERLOCK 

Function. 20 (CTTU) tests for a permanent file utility interlock 
Upon entry, FET+FTPM has the following format. 



FET+FTPM 




eq 
intf 



Equipment to test utility interlock on 
Interlock flag address; this word is set to one if 
the utility interlock is set and to zero if the 
interlock is clear. 



TSU obtains the Utility interlock status of the specified 
device using the TGBS subf unc t i on of the STBM monitor function. 
The 4-bit utility interlock mask field is extracted from the^ 
STBM return status and written to the interlock flag word using 
subrout i ne WI F . 



PF UTILITY PROGRAMS 

The Permanent File ut i I i t y prog rams have entry points PFATC1, 
PFCAT1, PFC0PY1, PFDUMP1, and PFL0AD1 and are found in decks 
PFATC, PFCAT, PFCOPY, PFDUMP, and P FLOAD , r espec t i ve ly . 

The key to the output listings produced by these ut i I i t i es is 
common deck COMCFCE - format cat a log . ent ry for output. FCE 
converts and formats a catalog entry into two 70 character 
Lines for output. Default header lines may be retrieved by the 
calling program, if desired, by referencing the locations CHDR1 
and CHDR2. The caller may optionally request that the file 
length be formatted in characters or sectors, the user index be 
formatted, or a four decimal digit line number be attached to 
the beginning of the line. 

FCE maps the internal codes for access modes, file types, 
permission modes and the creating subsystem type into 
appropriate display code equivalences. 
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COMCMAC macro EDCAT calls FCE 
format . 



This macro has the following 



LOCATION 


OPERATION 


VARIABLE SUBFIfclDS 




EDCAT 


caddr , waddr , lnum, len, index 



caddr Address of catalog entry 

waddr Address of working storage area (14 CM words) 

to return edited catalog entry to 
lnum Line number to be added to beginning of first 

line 
len Length code (1 = sectors, = characters) 
index Nonzero if index field is to be listed 



INTERLOCKS 

The permanent file utilities make use of t he f o I Ipwi ng 
interlock and activity controls available in NOS. 



Permanent File Activity Count 

The permanent file activity count is a count of the number of 
routines currently accessing the permanent file system. This 
count is maintained in the PFNL word in low core CMR. 



Permanent File Utility Interlock 

The permanent file utility interlock is a bit that is set in 
the MST for a device to indicate that a recovery, 
initialization or permanent file loading activity is being 
performed on that device. The setting of the permanent file 
utility interlock means that the routine requesting the 
interlock requires exclusive usage of the device. When set, 
the permanent file utility interlock ensures that no new 
permanent file activity will be initiated on a device. In 
order to ensure that no activity actually exists on the device, 
the PF system interlock is obtained while the utility interlock 
i s bei ng set . 

Tota I PF Interlock 

The total or system permanent file interlock is an interlock set 
in PFNL that prohibits permanent file activity. This interlock 
can only be obtained when the permanent file activity count is 
zero. 
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Catalog Track Interlock 



The catalog track interlock is set on a .particular catalog 
track to insure that neither the catalog track nor any of th 
fites Pointed to by the catalog entries in that catalog trad 
a re modi f i ed . 

^ u 4-u« i.^-iiitv nroarams to secure the 
PFU functions are used by the utility pruy.ci 

interlock or manipulate the activity count. 



PFATC UTILITY 

PFATC is a permanent file utility program that catalogs archive 

files. 

PFATC reads the archive file and lists the catalog entry by an 

EdJTat mTcro catl CLO = T option-default) and list the catalog 

image record CCIR) CLO = C option). 

Samples of PFATC output may be found in the NOS System 
Maintenance Reference Manual. ,. ^ 



The ma 



in routine of PFATC is f lowcha rted i n figure 36-4. 



60454300 A 



36-43 




Figure 36-4. PFATC 



60454300 A 



36-44 




issue message 

NO FILES 

PROCESSED 



issue message 

CHECK DAYFILE 

FOR ERRORS 



issue message 

CATALOG 
COMPLETE 



C 



ENDRUN 



Figure 36-4. PFATC (Continued) 
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PFCAT UTILITY 

PFCAT is a permanent file utility program which generates 
reports from the permanent file catalog tracks on a master 
device. The reports generated are as follows. 

• Listing of catalog file with files grouped by user index 
(LO = T) . 

• Statistical report of device usage (LO=S). 

In the case of the first report (LO=T) / a status listing of the 
mass storage configuration showing the usage of each mass 
storage device is also printed. 

A flowchart of PFCAT is shown in figure 36-5. 
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list 
individual 
files 





set up 
LO=S 
listing 



WSR 



write 
statistical 
report 



yS files^^ 
*\processed yS 



no 



issue message 

NO FILES 

PROCESSED 



yes 




yes 



errors 



issue message 

CHECK DAYFILE 

FOR ERRORS 



no 



issue message 

PFCAT 
COMPLETE 



f ENDRUN J 



Figure 36-5. PFCAT 
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PFCOPY UTILITY 

PFCOPY is a permanent file utility program that extracts files 
from an archive file and copies them to one or more local files 

PFCOPY copies files from the archive tape to local files at the 
control point. If a master file CMF) has been specified, all 
files are copied to that local file, otherwise files are copied 
to local files having the same name. Each, file may be preceded 
by its catalog and permit entries if the Q option had been 
specified. 

PFCOPY uses the CTCF PFU function to change names of various 
files at the control point. PFCOPY is the only utility that 
uses CTCF and does so only to avoid conflict between data file 
names and the archive file name. 

A flowchart of PFCOPY is shown in figure 36-6. 
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Figure 36-6. PFCOPY 
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PFDUMP UTILITY 

PFDUMP is a permanent file utility that copies files stored on 
permanent file device to a backup storage (archive) file. The 
files archived by PFDUMP may be restored by the PFLOAD utility. 

The dumping of permanent files has many options. A full dump 
is a dump of the entire family or removable pack in which only 
the family or pack name is specified (no options selected by 
the OP keyword. A selective or incremental dump is a dump of a 
family, device, or removable pack in which the modification 
date option (0P=M) has been specified. If any option other 
than M is specified, the dump produced is said to be a partial 
dump. 

Permanent file dumps do not require the system to be idle. 
However, as each catalog track is being processed, no user may 
access any files defined on that catalog track. 

A flowchart of PFDUMP main routine is shown in figure 36-7. 
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SDM 



send 

device 

messages 





SDL 



sort data 
list 



I 



PFU: CTRL 

read data 
list 



locate next 
catalog entry 



-O 





no 



issue message 
CATALOG 
INDEX OUT OF 
RANGE 




Figure 36-7. PFDUMP 
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initiate 

catalog file 

read 






TAF 



return 

dump files 

CATS, DATA, 

PETS 



CAC 



clear PF 
activity 



PGF 



purge files 



terminate 
archive file 



issue message 

CHECK DAYFILE 

FOR ERRORS 



1 



flush output, 
return PURGE 
file 



I 



RUP 



restore user 
PF parameters 



f ENDRUN J 



Figure 36-7. PFDUMP (Continued) 
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build PFDUMP 

control word 

for catalog entry 




add entry 

to PURGE 

file 



WDT 



write 

catalog 

to archive file. 



move catalog 
to output 




write data 
block 
Sto archive file 



ves /^T\ 



Figure 36-7. PFDUMP (Continued) 
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PFDUMP obtains information and data for a permanent file by 
using PFU calls and writes this information on an archive file 
that is usually a magnetic tape file. 

This discussion of PFDUMP concentrates on the following areas. 

• Obtaining the file from the permanent file subsystem 

• Writing the archive file 

• Error processing 

• Interlocking 



Obtain ing the File 

Obtaining the file from the permanent file system consists of 
device selection and file selection. Device selection is done 
during PFDUMP preset based on information read from the EST and 
MST contained in CMR. File selection is performed during 
dumping and is based on information read from the permanent 
file catalogs and direct access file system sectors. 



Device Selection 

Device selection consists of subroutines BMT (build mass storage 
tables), SBS (set boolean selection parameters), SSP (set 
selection parameters), and SMP (set master device parameters). 
These subroutines build or access the MSTT (table of MST 
information) which is a table of information extracted from the 
MST for each device under consideration. This table has the 
following format. 



MSTT+O 



+1 



59 




47 




35 29 


23 


17 15 


11 


7 5 


data 


cats 


pets 


nctr 


eq 


dn 





uc £ 


j mn 





sm 


dm 



data First track of indirect data chain 

cats First catalog track 

pets First track of permit chain 

nctr Number of catalog tracks 

eq Equipment number of device 

dn Device number 

uc Unit count - 1 

s On/off status 

mn Equipment mnemonic 

sm Secondary mask (direct access files) 

dm Device mask (indirect access files and catalogs) 
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The MSTT is built by subroutine ? MT - 
MSTs for mass storage devices using -tn 

A device is inc ^^^Ilon^C^JIords 1 FM, PN, and UN) supplied 
and user number selections tKey wo. u , words, 

in the utility call. The MSTT is terminated by two zero 



BMT reads the EST and 
e RSB monitor function, 
meets family, pack name 




DNSP is set 
The symbols 



to (false) . 

and their conditions are as follows. 



Symbo I 

DAFO 
DIDN 
DISP 
DITD 
DNMO 
DNSP 
DNTD 
FNFS 
IAFO 
TDMD 
TDSP 



Condition 

Direct access files only (OP=D) 
DI cataloged on DN 

specifed CDI=xx) 

cataloged on TD 

is a master device 

specified (DN=xx) 
_.. same as TD 
Force no f i les selected 
Indirect access files only 
TD is a master device 
TD specified (TD=xx) 



DI 
DI 
DN 
DN 
DN 



(0P=I) 



I„ addition to Producing the BFSP lis* :, SBS^ -odlfl .. th. 

iXi:inT^i e ,r:z^ <z a ^^ on d .vi.. « one „.. 

spe c i f i ed . 

Subroutine SSP interrogates BFSP and sets * h * j;!" 9 ^*^* 
!u j. / eec ^ aitpmate device selection (FSAD), secondary 

. U r a "e i cf section (FSSA) and sets the fjr,« "try ;n 
!;: i,„ to t he first device to be processed. The values sex 
by SSP Ire used primarily by subroutine SN» (set next dev.ce) 
to select the next device to be dumped. 

The alternate device selection, when nonzero, [Quires that a 
fi le be resident on ^^-^^^ ',, el^evi ce^'been 
^cesseS 'tne^ondary annate devi. ...l.ctlo, J ^P-es U 

iraile^e^cenelec^onTs-otrme ^f adhere 

ed from the first master device, but only f ^es 
resident on the secondary alternate device are selected for 
subsequentmaster devices. The secondary alternate devTce 
se?ec?ion is used for processing the true device option (TO). 

SSP calls subroutine EBE (evaluate boolean expression) to 
determine If the desired condition has been properly selected; 
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that is, appropriate bits are set in BFSP that agree with a 
file selection boolean expression. The selection expression is 
built through a macro (BOOL) using the boolean file selection 
variables described above. Each expression is referenced by a 
location where the mask is stored for the bits that must be set 
in BFSP for the condition to have been met. The expressions 
are as follows. 



Symbol 

SDFL 
ADDN 
ADTD 
SATD 
FMON 
FMTD 
FMDI 
NFSL 



Condition Tested 



Single device selected 

DN i s 

TD i s 

TD is 

DN is 

TD is 

DI is 

No f i les se lected 



a Ite mate devi ce 
a I ternate devi ce 
secondary alternate device 
first master device 
f i rst master devi ce 
first master device 



Subroutine SMP builds the permanent file description word (PDWD) 
for the device being dumped and sets the number of catalog 
tracks (NCAT) and device mask (MASK) using the MSTT and single 
device selection (FSSD). The PDWD has the following format. 



59 



17 



pn 


eq 


y/////// 



11 



pn if a family dump; pack name if an auxiliary 

device dump 
eq Equipment number of a family member if a family 

dump; if an auxiliary device dump 

If an auxiliary device is being dumped, the pack name, unit 
count, and equipment mnemonic are set in the PURGF FET so that 
files may be properly purged if the 0P=P option is selected. 



File Selection 

Subroutine RCE (read catalog entries), 6RL (generate read list) 
and SDL (sort data list) are used to prepare a list of files to 
be read using the PFU function CTRL. Subroutine RCE reads 
catalog entries from the CATS file into a working buffer. 
These catalog entries are analyzed by GRL to build a list of 
files meeting the selection criteria for the dump. Subroutine 
SDL then sorts the list in order by track and sector to 
minimize mass storage positioning. 

Each file is analyzed by subroutine GRL to determine if it 
meets the selection parameters specified for the dump. The 
direct only (0P=D) and indirect only (0P=I) selection 
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i *.^a k« KRL Subroutine CSP (check ■ . 
parameters are evaluated by 6RL. ™ Luate the user ind ex CUI>, 

fo I lowing format . ■ 



59 



47 



2000B+ci 



23 



11 



tk 



sc 



C 1 

Lf 
tk 
sc 



for 
10 is 
forced 
6 are 



Catalog index into catalog buffer 

Length of file (indirect access only) 

First track of fUe * • i « e - 

First sector for indirect access files, 

direct access files, bit 1 1 is set bi t 

zero for normal processing or one for a 

device number 

x-i ~ roi a ten caLLs subroutine CDS (check 
For direct access files GRL also cal is a the fUe 

device status) to verify that the residency ^ ^ . c 

exists in the system CMSTT) . If not, xne 
is issued and the file is skipped. 

PFDUMP - DEVICE NOT FOUND, FN=nnnnnnn,U I=uuuuuu,DN=dd . 



A final select 
when PFU reads 
dumps (0P=M) t 
read function 
the last modif 
access file en 
control word i 
status of this 
The file is co 
is satisfied a 
the system sec 
and analyzes i 
E r ror condi t io 
with one of th 



ion process is peformed 

the system sector for 
he last modification da 
(CTRL) parameter. PFU 
ication date in the sys 
countered in the read I 
s written to the data f 
comparison and other p 
pied to the buffer only 
nd no error condition i 
tor control word using 
t using subroutine CFS 
ns indicated in the con 
e following diagnostics 



for direct ac 
the file. For 
te is passed t 
compares that 
tern sector of 
i st . A system 
i le buffer to 
ossible error 

if the modifi 
s detected. P 
subroutine RPR 

(check f i le st 
trol word are 



cess files 
incremental 

o PFU as a 

date with 

each direct 
sector 

i ndi cate the 

condi t i ons . 

cation date 

FDUMP reads 
(read PRU) 

at us) . 

identi f i ed 



DAF BUSY. 

DAF ZERO LENGTH. 

BAD SYSTEM SECTOR. 



Selecting a Device to Dump 



Subroutine SND (se 



t next device) is called from the main loop of 



Suorounne jnu vo<=«. ..w~w ----- Humned. 

PFDUMP to select the next device to be dumped. 
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On the first call, SND scans the table of MST information (MSTT) 
for the first master device- If a master device is found, 
information from MSTT is used to set the master device 
description (MDDS), catalog description user index (PDUI), 
master equipment number (MAEQ), number of catalog tracks (NCAT), 
and the master device number (CPAR+CPDN). The files CATS, PETS, 
and DATA are set up for the master device using calls to the 
PFU function CTOL. The catalog track interlock is set 
according to POUI using the CTSC option of the PCINT (process 
catalog interlock) macro. Status is then returned to the 
caller indicating the device number to be processed (-1 for an 
auxiliary device) or zero if no master device was found. For 
alternate device dumps the device number returned is the 
alternate device rather than the master device. 

On subsequent calls, SND clears the catalog track interlock for 
the master device being processed. If a single device dump is 
not being performed, MSTT is scanned for the next master device. 
If another master device is found, the master device parameters 
are set up, the CATS, PETS, and DATA files are opened and the 
catalog track interlock is set for the new master device. As 
in the first call, status is returned, i ndi cat i ng t he device 
number to be processed (-1 for an auxiliary device) or zero if 
no more master devices remain to be processed. 



Writing the Archive File 

The archive file is assigned to the control point using the 
LABEL macro. If the archive file has not been pre-assigned 
(assigned to the control point prior to the utility call), the 
LABEL macro requests a tape having the specified track type 
with the installation density. A tape, mass storage, or null 
equipment may be assigned to the archive file by the console 
operator in response to the flashing label request. The file 
is opened with read/no rewind and the file ID is set to 0. 
This same logic is followed for the verification file if one is 
desired (keyword V and VF). Both files are rewound unless the 
no rewind (NR) option is selected. 
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of the archive file (and the archive 



Writing and positioning ot me dimiv^ ..«.* >-..- -■■- _ 
verify file if necessary) is accomplished using the V 
macro The type of operation to be performed is selected usin 
macro. Tne type or «h macro. The ARCHIVE macro has 

the function code option oT tne mouu. 



the following format. 



LOCATION 



OPERATION 

ARCHIVE 



VARIABLE SUBFIELDS 

fnc,pl,p2 



f nc 



Function code mnemonic: 



p1 
p2 



WRITEW 

WRITER 
WRITEF 
SKIPFF 
FLUSH 



Write words on archive file; 
pi = working buffer address, 
p2 = word count 
Write EOR on 
pa ramet ers) 



Write EOF on 
pa ramet ers) 
Ski p arch i ve 



archive f i le (no 
archive file (no 



f i le 



forward; p1 = file count to skip 
Flush archive file buffer (no 
pa ramet ers) 



First parameter 
Second parameter 




write I/O. 



macro . 



The SKIPFF option is processed using the S K IPFF ^stem 
The FLUSH option is processed using a call to the subroutine FCW 
(flush buffer using control word write) which ^sues the 
WRITECW system macro if there is still data in the buffer. 
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Archive File Control Words 

Information written to the archive file is divided into blocks. 
The first word of each block is a control word which identifies 
the number of data words in the block and the type of 
information contained in those data words. The format of the 
control words is as follows. 



59 



17 14 11 8 



file name (catalog control word only) 




a 


b 


c 



One of the following: 



Label 

1 Catalog 

2 Permit 

3 Data 

4 Not used 

5 CIR (catalog 
7 End of dump 



image record) 



One of the following: 






Data 


1 


EOR 


2 


EOF 


7 


End of dump 



c Number of words until next control word 
(excludes control word) 

A symbol is defined for the more common combinations of the a 
and b fields for control words. These values are as follows. 



Symbol 



Value (ab) 



LCWC 


01000 


CCWC 


11000 


PMCW 


20000 


PRCU 


21000 


DCWC 


30000 


DRCW 


31000 


DFCW 


32000 


CICW 


50000 


CRCW 


51000 


CFCW 


52000 


EODC 


77000 



Definition 

Label control word 

Catalog control word 

Permit control word 

Permit record control word 

Data control word 

Data record control word 

Data file control word 

Catalog image control word 

Catalog image record control word 

Ca.talog image file control word 

End-of dump control word 
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Archive File Label 

^ • . u ■« a* + * lahpi that describes the parameters 

during the preset phase of PFDUMP. 



archive file label) 



f rm 



the 



Subroutine SLP copies the co?v.rt,.d p.r.-et.r. tr. CPAR" to 
data label starting at the sixth word C ^9^ e J? °^ by 
specified number of files CSK parame ter ) a iPP e ^ arch . ve 
subroutine LBL before the data label is written 
file. 

T , Hata LabeL i s written to the archive file as a record by 
Itsell and ^preceded by a control word in the following 
format . 



59 



17 14 11 8 







PFDUMP 







Label type control word (0) 
End of label flag (1) 
Word count for label (100) 
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59 



35 



23 







LBL 



L.BL + 5 



PFDUMP 



reel 



mask 



number catalog tracks 



reel number 



device map number 



date - yy/mm/dd. 



time - hh.mm.ss. 



family name 



pack name 



archive file name 



verify file name 



output file name 



permanent file name 



master file name 



user number 



list options 



utility options 



user index 



destination user index 



device number 



true device number 



destination device 



number files to skip 



number files to process 



rewind flag 



unload flag 



verify flag 



nine-track flag 



mass storage error option flag 



date and time 



Figure 36-8. Tape Label Format 
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Catalog Image Record 

The catalog image record (C1R) is written during the preset 
phase of PFDUMP if an incremental dump is being performed (0P=M, 
but not with OP=B) . The CIR is written by subroutine CCI 
(create catalog image). 

CCI waits for no permanent file utility interlock on a device 
using a call to subroutine WUC (wait PF utility interlock 
clear). CCI then calls PFU with the CTCT function to locate 
the correct catalog track, with function CTOL to open a catalog 
track file, and with function CTSC to interlock the catalog 
t rack . 

CCI reads the catalog file generating catalog image entries of 
the following form using subroutine BCL (built catalog list). 
There is 1 entry for each file on the catalog. 



59 


41 


35 


17 


permanent file name 


user index 


access count 


dn 


last access date and time 



Catalog image blocks are written using a call to 
(write image block) which writes the image block 
word on the archive file. 



subrout i ne WIB 
with control 



At the end of each catalog track, an appropriate CRCW type 
control word is written. The catalog track interlock is 
advanced via a CTAC PFU call. When all catalog tracks have 
been processed, PFU function CTCC is issued to clear the 
interlock on the last catalog track. 



Writing the Permanent File 

After starting the file dumping with the CTRL PFU function, the 
main loop of PFDUMP now begins individual file dumping to the 
archive file. The catalog entry, permit entries and data for 
each permanent file are written to the archive file as a 
separate logical record. 
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The cont ro I word 
control word code CCWC. 



for the catalog entry is built as follows with 




A call to subroutine WDT (write dump tape) writes the control 
word and the catalog entry to the archive file. 

The catalog entry is then checked for a permit random index and 
if one is present, subroutine RPF (read permit file) is called. 
RPF randomly reads the permit file and calls subroutine WDT to 
write permit sectors to the archive file. Each permit sector 
is preceded by a permit control word (PMCW) in the following 
f o rma t . 




The last block of permits (may be the only block of permits for 
the file) is preceded by an end of record permit control word 



(PRCW) in the following format. 




n Number of words in permit sector 

The permanent file data is written using a call to subroutine 
WDB (write data block). 



60454300 A 



36-64 



uihr rails subroutine RPR Cread PRU) to retrieve the control 
word p ed Si?h ea^h sector placed in the DATA buffer by the 
C?RL PFU function. The control word has the following format 

11 




ec 
ct 
c s 
c 
n 



Error code 

Cur rent track 

Current sector 

Control (linkage byte 1) 

Number of words of data (linkage byte 2> 



Fields c and n are the sector linkage bytes from the mass 
sma e device. If c and n both are --the control word 
represents the end-of-inf ormation for the file. If c ^ zero, 
and n is nonzero, the control word represents an end-of file. 

? c i nonzero and n is not a full PRU (=NWPR) the control 
word represents an end-of- record . If ec Js nonzero, the 
control word represents bad data. 

The data taken from the DATA file buffer is 9-^!^ ^ 
blocks of up to 777B words. A control wo rd ( DCWC) n the 
following format is appended to the front of each block before 
the block is written to the archive file using subroutine WDT. 




Block word count 
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When an end-of- record CEOR) is detected in the DATA buffer, an 
end-of-record data control word (DRCW) is written. The EOR 
flag in the control word indicates the presence of an EOR 
following any data that may be associated with the control word 
The format of the EOR control word is shown below. 



59 




14 


8 





'//////////////// 


////////////////// 








^§%^^/% 


%%^%^%^ 


31 




n 



n Number of data words in the block (preceding EOR) 

End-of-files are represented on the archive file with an end-of 
file data control word (DFCW) in the following format. 



59 



14 



'WtMMMMMM, 


32 


n 



n Number of data words in the block (preceding EOF) 

The end-of-i nf ormat ion for the permanent file is represented by 
an EOR on the archive file itself. 

After the E 1 has been written, WDB returns to its caller. 

Subroutine WDT (write data to tape) manages the writing of 
control words and data to the archive file. Subroutine WDT 
writes the specified data to the archive file using calls to 
subroutine WRT (write control word and data). Extra control 
words are added to the data written to the archive file by WDT, 
if necessary, to insure that no block has more than the maximum 
possible word count (777B) . 

Subroutine WRT writes the control word and data using ARCHIVE 
WRITEW macro calls or writes an EOR using the ARCHIVE WRITER 
call. 



Archive File Termination 

Subroutine TAF (terminate archive file) is called when the dump 
has completed from the main loop or from AEP (about end 
p rocesso r) . 
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Subroutine TAF closes the archive file if open ^ ar f hlve ,^ lLe 

dump label has been written) and returns it (and also the 

archive verify file if necessary) unless suppressed by the no 
un load opt ion . 

The archive file is closed by writing an end of dump control 
word CEODC), an end-of-r ecord and an end-of-file. The control 
word is formatted as follows. 




Unless suppressed by the no unload option 
file is also written to the archive file, 
buffer is flushed using an ARCHIVE FLUSH macro call. 



(NU) an extra end-of- 
The archive f i le 



Purge After Dump 




that were dumped) is called. 

For each entry in the PURGE file, subroutine PFG puts the file 
name and user index in a FET (PURGF), displays a ■•«■«■« 
indicating the file name and user index being purged, uses the 
SETPFP macro to set the proper user index in the control point 
area, and calls PFM with the PURGE macro to purge the file. 



Inter locki ng 

PFDUMP conforms to the permanent file inter 
permanent file activity, permanent file uti 
catalog track interlock. 

PFDUMP requests that the permanent file act 
incremented during the preset phase by subr 
activity count). Subroutine SAC issues the 
to increment the permanent file activity co 
ACFL is passed to PFU with the CTIA functio 
to identify when the activity count has bee 
flag is used during abort cleanup so that t 
may be decremented if necessary. The folio 
message is displayed on the K display and a 
while PFU is being called to increment the 

SETTING PF ACTIVITY COUNT 



lock mechanisms of 
li ty active and 



ivity count be 
outine SAC (set PF 
CTIA PFU function 
unt. The address 
n as a status flag 
n incremented. This 
he activity count 
wing informative 
t message line 2 
activity count . 
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The permanent file activity count is decremented when PFDUMP 
completes or is aborted. Subroutine CAC (clear PF activity 
count) issues the CTDA PFU function to decrement the activity 
count only if the contents of ACFL indicates that the activity 
count has been incremented. The following informative message 
is displayed on the K display and at message line 2 while PFU is 
being called to decrement the activity count. The flag ACFL is 
cleared by PFU when the activity count is actually decremented. 

CLEARING PF ACTIVITY COUNT. 

PFDUMP interlocks the catalog track by using macro PCINT. Macro 
PCINT calls subroutine PCI (process catalog track interlock) 
with the PFU function to be used in interlocking the catalog 
track. The functions used are: CTSC to set the interlock; CTAC 
to advance the interlock to the next catalog track; and CTCC to 
clear the interlock. PCI displays the following informative 
message on the K display and at message line 2 while PFU is 
performing the specified interlocking operation. 

WAITING FOR CATALOG INTERLOCK. 

PFDUMP tests the permanent file utility interlock using a call 
to subroutine WUC (wait for PF utility interlock clear). This 
is done to insure that any PF utility activity (PFLOAD, CMS) has 
completed on a device before PFDUMP processes it. Sub rout i ne WUC 
issues PFU function CTTU to retrieve the permanent file utility 
interlock status. The following informative message is 
displayed on the K display and at message line 2 until the 
permanent file utility interlock on the device is clear. 

WAIT FOR PF UTILITY ON xx. 

Error Processi ng 

Error Processing fits into two categories: parameter 
processing, which includes missing files, device, or user; and 
errors in reading and writing permanent file archive data. 
This discussion is limited to the latter case. 



Reading Catalog Entries 

PFDUMP reads catalog entries (subroutine RCE) with CIO error 
processing selected (ERP1S assembly option). If an error status 
is returned while reading the catalog file, subroutine RCE 
resets the bad data in the circular buffer and sets the OUT 
pointer to point to the bad data. 

Subroutine PCE (process catalog error) is called from the main 
loop and from subroutine CCI (create catalog image) to process 
an error detected by PCE. Subroutine PCE calls subroutine GFP 
(get file parameters) which retrieves the equipment, track, and 
sector in error (using the STATUS macro). Subroutine PCE 
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track, and sector of * h * er £ sector affect ed by the mass 
J^r^r.r'ro'r' fl Th«^-«. t .S.s identify the file..,.-., and user 
indexes of files affected by the error. 

If the error occurs in the last cat. lo 9 ^'^/"^V^ 
error ported 1. -rong s.eto ad .n .n^ ^^ pc£ 

r:ini?i^es e tnrread on h thrcatalo g file and processing may 

caLL to subroutine Shi *>set errui 
function. 



Reading Permit Entries 



it ca I Is 



If subroutine RPF (read permit file) < ete °"" t ";%? E caU s 
^routine PPE process perm, t errors) Su rout ne ^ ^ 

subroutine GFP *° r ^* 31 SuSrout 1 ne PPE issues an appropriate 
sector) of the error. SUD ' h error idle status on 

error diagnostic and calls SEI to set tne 



the device. 



A permit read error control - rd wi th the following forma t is 
written to the archive file in place of the bad sector. 
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ERROR** 



Dumping is 



continued with the data for the file. 
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Readi ng PF Data 

Subrouting WDB (write data block) interrogates the control word 
passed with the data by PFU. If a bad sector is detected, it 
is written to the archive file as a block by itself. A read 
error data control word in the following format is written with 
the block so that the data may be identified as being bad. 
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17 


14 


11 





ERROR** 


ep 


3 


ty 


wc 



ep Error processing status: 

1 EO not spec i f i ed 

2 EO spec i f i ed 



ty 



B lock type 

Full or EOI 

1 EOR block 

2 EOF block 



b lock 



wc 



Block word count 



Subroutine IDM (issue data messages) is called to issue an 
error diagnostic identifying the file and location (equipment, 
track, and sector) of the error. If the dump can be continued 
(not fatal error and not EOI), the EO selection is checked. If 
EO has not been specified, the remaining data in the file is 
processed. Otherwise subroutine SFD (skip file data) is called 
to properly position the data file to the next permanent file. 

If direct access file length errors are detected by WDB, the 
appropriate too short or too long diagnostic is issued, a 
length error control word is written on the archive file, and 
the error idle status is set using a call to SEI. Processing 
is continued with the next file. The control word (LGCW) is 
formatted as follows. 
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ERROR**- 





3 


2 
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Writing the Ar ch i ve/ Ve ri f y File 




The K display message 

UNRECOVERED PARITY ERROR - 
ENTER K.GO - CONTINUE. 

K.END - ABORT DUMP. 



is displayed and PAE calls the keyboard processor KIP (from PFS) 



P 
to wait for operator action. 

If END. is selected the following message 
dump is aborted. 

WPE UNRECOVERED - ABORT. 



i s i ssued and the 



If 60 is 



selected, the current reel is closed with J^e 

If the close operation is successTuu 



reel. If the close is unsuccessful, however, the following 



message i s 



issued and the dump is aborted. 



WPE UNRECOVERED - ABORT. 

PFLOAD UTILITY 

PFLOAD is a permanent file utility that Loads files from an 
archive fite onto a permanent file device. The following 
paragraphs describe PFLOAD options. 

A noninitial load option (0P=N) ver i f 1 est hat n o i ndirect 
access files exist on a device before the load is allowed. a 
reolace option (0P=R) causes files from the archive file to 
replace already on the device being loaded. The normal 

P=t specified) causes files from the archive lie to 
be ignored if they are already present on the device being 
loaded . 

An incremental Load is performed by reading ^s^ 1 ^^ 6 
record CCIR) from the most recent incremental PFDUMP top n; . 
Each item in the CIR represents a file active in the permanent 

e tern at the time of the incremental <0P=«) dump As the 
archive file is processed, if a match is found in the CIR, the 
file Is a candidate for loading and the entry in the CIR is 
cleared Files not found in the CIR are skipped since they 
have etcher already been loaded or they were purged after the 
archive file being processed was written. 

Direct access files are loaded onto the device number on which 
^I M ^ e nd 1S seco^^°::s k 0n bit h :ore;p^ing to the user inde, is 
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not set). If the file cannot be Loaded on the original device, 
it is Loaded on the destination device (DD keyword) if one is 
specified and if the fiLe is allowed to reside on that device. 
If the file cannot be loaded on either device, a diagnostic 
message is issued and the file is skipped. A direct access 
file is considered to have resided on the master device being 
loaded if it originally resided on its own master device. 



Tape errors may be encountered when Loading a file. These 
errors are processed by setting the length of the file to 
amount of the file processed at the time of the error and 
continuing with the next file. 



the 



A 



flowchart of PFLOAD main Loop is shown in figure 36-9 



60454300 A 



36-72 




Figure 36-9. PFLOAD 
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get permit 
random index 




<D 







permits present 

that should 

not be 



I 



SEM 



send 

error 

message 





SEM 



send 

error 

message 



SER 



skip to 
EOR 




Figure 36-9. PFLOAD (Continued) 
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Figure 36-9. PFLOAD (Continued) 
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This discussion of PFLOAD concentrates on these areas: Loading 
the file, assigning the archive file, transferring the file to 
mass storage, interlocking, activating PFU, and error 
processi ng - 

Loading the File 

PFLOAD performs the same device selection mechanism as does 
PFDUMP. Subroutines BMT (build mass storage tables), SBS (set 
boolean selection), SSP (set selection parameters), and SMP 
(set master device parameters) are virtually the same for both 
routines and therefore will not be discussed in detail here. 

The boolean file selection variables are identical to those in 
PFDUMP, but PFLOAD adds two file selection boolean expressions: 

DSTD Display true device 

DSDI Display device for destination user index 



File Se lect ion 

Subroutine PCB (process catalog buffer) is called to read the 
catalog entry and determine if the file is to be loaded. 
Subroutine PCB calls subroutine CSP (check selective parameters) 
which determines if the file meets specified date, user index, 
permanent file name, and alternate device options. 

If the file is to be loaded, the catalog image is checked by 
subroutine CCI (check catalog image) to determine if the file 
is to be loaded during an incremental load. The catalog image 
record file (CIRF) is read to determine if the file exists on 
the CIR. If a match is found, the entry is cleared, and the 
load file status is returned. The load file status is also 
returned if the load is not an incremental load. This mechanism 
means that if an incremental load is being performed, only 
those files which are found in the CIR can be loaded and once a 
file is loaded it is removed from the CIR. 

If the file is still a candidate to be loaded, subroutine PDI 
(process destination index) is called to process the 
destination user index. If a destination index has been 
specified, it is written into the catalog entry and the device 
number is set to the corresponding device. 

The access type of the file (di rect/ i ndi rec t access) is then 
checked to determine if the file satisfies any specified access 
type selection parameter (0P=I or D). If the access type 
selection is satisfied, the file continues to be a candidate 
for loadi ng . 

If the candidate file is a direct access file, PCB determines 
whether the residency device is available and if so, whether the 
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device is still a valid residency device for the user (that is, 
correct secondary mask bit set for the user index) . If a valid 
residency device is not found, validation of the destination 
device (DD keyword) is done. If no DD is specified or it is not 
valid for the user, the following diagnostic is issued and the 
file is no longer a candidate for loading. 



ALTERNATE DEVICE NOT FOUND. 



If the DD device is valid it is put 

becomes the new residency device for the file. 



i nto the cata log and 



a call to 
If the f i le 



i s 



PCB now sets up master device parameters using 

subroutine SMD (set master device, parameters). _ 

on the same master device and catalog track as the previously 

loaded file, SMD requests the permanent file utility interlock 

usinq a call to subroutine SIN (set PF utility i n t e r loc k ) _ and 

activates PFU using a call to subroutine AUP (activate utility 

processor) . 

If the file is on the same master device but a different 
catalog track, SMD checks to ensure outstanding PFU activity 
has ceased. If PFU is not active, it is activated on the new 
catalog track using the SIN/AUP sequence described above. If 
active, subroutines FCP (finish catalog processing) and PCT 
(position on catalog track) are called to complete processing 
of the old catalog track and to establish processing on the new 
r.atalog track. If the file is on a different master de 
D gets the catalog parameters for that device using a 
U call, sets up a CATS, PETS, and DATA FST entry for 
ster device and opens these files using CTOP PFU call 



different master device, 

CTCT 
the 

s. SMD 
then%xecutes the SIN/AUP sequence to set the utility interlock 
and activate PFU on the new device. 



Subroutine PCB then calls subroutine SFF (search for file) 
determine if the file already exists on the permanent file 
device. If it does, the file is no longer a 

specified (0P = R) . If 



to 



candidate for 
loading unless the replace option is specifie 
replace option is specified, the file is purged using 
subroutine PGF (purge file). If the purge is successful, th 
continues to be a candidate for loading. 



the 



s 

f i le 



The candidate file is now ready to be loaded. Subroutine MCE 
(move catalog entry) is called to move the cat a log ent ry t o the 
CATS buffer. Subroutine PCB 
file flag set. 



exits to the caller with the load 



If the file is not a candidate for loading, PCB sets the skip 
to EOR (SKER) flag and returns with the load flag clear. 



Permits Processing 

The next archive file control word is read using a call to RCW 
(read control word). The control word and catalog entry permit 
random index are verified to ensure that permits are present 
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when the catalog so indicates and not present otherwise. The 
following diagnostics are used to report permit mismatches 
between the catalog entry and archive file. 

PERMITS PRESENT THAT SHOULD NOT BE. 

PERMITS MISSING. 

Subroutine PPB (process permit block) reads permit entries from 
the archive file and writes them to the permit file using a 
call to subroutine WPR (write PRU to PFU circular buffer). 
Subroutine PPB sets the random index of the permit entries in 
the catalog entry and sets permit linkage in the permit entry 
before calling WPR. If the archive file permit block is empty, 
the permit random index is cleared from the catalog entry and 
no writing is done. Subroutine PPB returns to the caller with 
the load file status set unless file loading is suppressed 
because of a tape error. 

If the archive file control word indicates that there was an 
error while dumping the permit entries, subroutine SCE (set 
catalog error code) is called to indicate that the permits were 
in error. Processing of the permit entries then continues 
no rma I ly . 

If the permits cannot be loaded, an appropriate diagnostic is 
issued, the skip to EOR flag (SKER) is set, and subroutine PPB 
returns to the caller with a file not to be loaded status. 



Data Processing 

The next control word is read from the archive file using RCW. 
If a nondata type block is present, the following diagnostic is 
issued and processing continues with the next file. 

NO DATA BLOCK. 

Subroutine PDB (process data block) is called to process the 
data. PDB sets up a control word in location LWRD that has the 
following format. 




address of 
catalog entry 




dn for indirect access file; 

4000 for a direct access file on an auxiliary device; 
device number for a direct access file on a family 
devi ce 
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Tho data is read from the tape according to the archive file 
lontrolword' Subroutine PDB updates LWRD «i th add 1 1 , ona I 
control information as follows. 



59 



53 



address of 
catalog entry 




wc 



i f norma I 
Word count 



1 if EOF 



(DLEF); 2 if EOI (DLEI) 



PDB now calls sub rout i neWPR to move the data t o the DA TA F E T 
buffer. PDB continues until all data has been y* through 
the archive file. Once the EOI has been sent o through 
WPR, PDB returns to the caller with a load file status. 

If an archive file control word indicates a J Ue .^ u ""*^ n fLaq 
,rror, the following diagnostic is issued, J he » kl P.^ " *^ 9 
i se , the catalog is updated to reflect the rue engt h and 
control is returned to the caller with load file status set. 



FILE TRUNCATED filenam userin. 
If an archive file control word is 



PDB sets the data error 
file processing is 
control word is a supp 



st atus in 



a read error control word, 
the catalog entry. If bad 



suppressed CEO selected) or the error 
oppressed file control word (EO _ spec i f i ed 




error 



condition was present in the control word. 



EOR 



When a tape error or abnormal condition is sensed on the 

archive tape, an appropriate diagnostic ^ V The^ta li£ is 

is written and the catalog is 

The load f i le 



(SKER) is set, an EOI sector 



updated to reflect the true length of the ^ Le - 
status is set and control is returned to the call 



er 



Catalog 



(finish 



After the data has been processed, subroutine FCP 
catalog processing) is called to complete the loading of the 
file FCP advances the CATS IN pointer and performs CATS 
buffer writing as required using calls to FCW (force catalog 



write) . 
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End-Of-Load 

Subroutine CEL (check for end of Load) is called to advance to 
the next file and determine if the Load has finished. 
Subroutine CEL checks the SKER (SKIP to EOR) flag and calls 
subroutines DUP (drop utility processor), CIN (clear utility 
interlock), and SER (skip to EOR) if the flag is set. 

If an individual file was selected to be loaded (PF keyword) and 
that file was loaded, CEL sets the load complete status and 
returns to the caller. If this is not the case, the 
incremental load flag is checked. If this is an incremental 
load and the catalog image record is now all zero (all 
incremental files processed), the load complete status is set 
and control returns to the caller. 

If this is not the case, the next archive file control word is 
read. If the control word is a catalog control word, CEL 
returns to the caller with the load not complete status. If 
the control word is a label control word, subroutines DUP and 
CIN are called and subroutine PAL is called to process the 
archive file label. CEL proceeds by reading the next control 
word and interrogating it as above. 

If an EOR is detected on the archive file, CEL reads the next 
control word and interrogates it as above. 

If an EOF is detected on the archive file, and no more files 
are to be processed (N keyword met or not specified), it is 
treated as an archive file EOI. If more files are to be 
processed, subroutines DUP and CIN are called, archive file 
reading is reinitialized and subroutine PAL is called. 
Subroutine SCI (skip catalog image) is called to properly 
position the archive file. The next control word is read and 
interro gated. 

When the archive file EOI is detected, end of load status is 
returned to the caller unless an incremental load is being 
performed and more files remain on the catalog image record. 
When more files remain for an incremental load, subroutine ART 
(archive file transition) is called to process operator 
intervention. Depending upon operator action, either end of 
load status is returned by subroutine CEL or the first control 
word of the next archive tape is analyzed to determine the next 
action of subroutine CEL. 

The operator may choose to end the load, list files remaining 
on the catalog image record or proceed to the next tape of an 
incremental load set. Subroutine LFS (list files on catalog 
image record) is called by subroutine ART to list files if the 
list option is selected by the operator. Subroutine AAF 
(assign archive file) is called to request the next tape for 
the incremental load if that option is selected by the operator. 

If the control word is an end-of-a rch i ve file control word, and 
no more files are to be processed (N keyword not specified or 
has been met), the end of incremental load test is performed. 
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If the archive file is not positioned at an EOF/EOI, it is so 
posUioneS using a SKIPFF macro. If now positioned at an EOI, 
the end of incremental Load test is performed; otherwise, the 
condition is treated as an EOF control word. 

If a valid control word is not recognized or a parity error 
status is returned from RCW, a diagnostic is issued, 
subroutines DUP and CIN are called, a skip to EOR is performed 
(call to SER) and the next control word is interrogated. 

The main loop of PFLOAD either continues with processing of the 
next file or calls subroutine EOL (end of load processing) and 
performs an ENDRUN, depending upon the status returned by 

subroutine CEL. 

Subroutine EOL drops PFU using subroutine DUP, clears the 
utility interlock using subroutine CIN, returns the load 
scratch files (CATS, PETS, DATA, and so on), issues appropriate 
end-of-Load messages, and restores the user permanent tile 
parameters to the control point area using subroutine RUP 
(restore user permanent file parameters). The archive file is 
then positioned to skip any remaining file count (N parameter) 
if the NR parameter is specified or is returned if not 
speci f i ed . 

Archive File Assignment 

Subroutine AAF (assign archive file) unloads the current 
archive file (expected on first call to AAF), does a LABEL 
request for the next archive file, positions it as required by 
NR and SF keywords, initiates file reading using the READCW 
macro, and calls subroutine PAL (process archive 
check the label. 



f i le label) to 



If good label status is returned by subroutine PAL, subroutine 
AAF returns to its caller. If not, the following message is 
displayed and the LABEL request is repeated. 

PFLOAD - LABEL BAD, ASSIGN NEW TAPE. 

PAL reads the first control word from the archive file (using 
RCW) and if it is a label control word, reads the remaining 
label data. 

The K display is updated from the date, time, and mask fields 
in the label, an output file message containing the date and 
time from the label is generated, the archive file is positioned 
to EOR using subroutine SER, and good label status is returned 
to the caller. 

If a bad label is detected (control word is incorrect, label 
identifier is incorrect, or the label read is incomplete), an 
SER (skip to. EOR) is performed, and a bad label status is 
returned to the caller. 
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Transferring Files to Mass Storage 

Once the permanent file utility processor (PFU) has begun 
processing the CTLM (load main loop) function, data transfer 
operations may be done through the circular (or FET) buffers 
associated with the PETS and DATA files. Subroutine WPR (write 
PRU to PFU circular buffer) moves data from a working buffer to 
the desired circular buffer. WPR is a general subroutine which 
is passed the address and size of the working buffer and the 
address of the FET. 

WPR examines the sector counter in FET word FTSC. If bit 11 of 
the sector counter is set, PFLOAD has reached sector threshold 
during an earlier request and the buffer needs to be flushed 
(emptied) before proceeding. Subroutine FUB (flush utility 
buffer) is called to issue PFU write requests until the buffer 
has been emptied. The sector counter is reset to zero and 
processing is continued. 

Once sector threshold has been eliminated, subroutine WPR 
checks to see if data is to be transferred. If no data is 
present in the working buffer, WPR returns to the caller. If 
data is present, subroutine WPR determines if the data to be 
transferred will fit in the circular buffer. If there is 
insufficient room in the circular buffer and the buffer is not 
busy, a write request is issued. If the buffer is busy or 
after a request is issued, subroutine WPR waits in periodic 
recall for buffer space to become available. 

Once space is available, the data is moved from the working 
buffer to the circular buffer. The sector counter is 
incremented and subroutine WPR determines if it is necessary to 
issue a write request. If the buffer is at least half full a 
write request is issued before returning to the caller. 

The permit and data buffers are also flushed under force 
catalog write and delete incomplete file situations by 
subroutines FDB (flush data buffer) and FPB (flush permit 
buffer). These two routines call FUB with the appropriate DATA 
or PETS FET address. 

The catalog file (CATS) is written by subroutine FCP (finish 
catalog processing) using a call to subroutine FCW (force 
catalog write). Subroutine FCW first calls subroutines FDB and 
FPB to flush the DATA and PETS buffers. A write function is 
then issued on the CATS FET and subroutine FCW waits in RECALL 
for the function to be completed by PFU. Subroutine FCW then 
rewinds the FET buffer, clears the sector counter (FTSC), 
clears words in the sector (NWIS) and returns to the caller. 

The PETS and DATA buffers are also flushed when an incomplete 
file is deleted. Subroutine DIF (delete incomplete file) is 
called by subroutine MCE to flush a partially loaded file, thus 
ensuring that the previous file has been properly terminated 
before processing a new file. DIF is also called during bad 
file processing by PDB (that is, EO specified). If the 
incomplete file flag (IPFF) is set on entry, subroutine DIF 
calls subroutines DDS (delete data space) and DPS (delete permit 
space) and clears the incomplete file flag. 
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FET for processing by PFU 

routine DPS calls subroutine FPB tc .flush the per.it buffer^ 

and then resets the p.r.it random ndex po "*^ 

f ° Und :Yin "e 9 E 9 TS e F T^it h n w random index set in FTP*. 
;rEOrconrroi h :ord T isTet in the working buffer and W PR ,. 
called to terminate the permit chain. 

being performed on that device. 

ctm (**t PF utility interlock) is used to request 
Subroutine SIN (set PF utiniy ... interlock is 

:% \irixi; t .:;/Sx u H t it: t pi.;: t ;i;i o ;Siioi!n h :.:r. B . -u. 

issuing a CTSU PFU function to set the interlock. 

SETTING UTILITY INTERLOCK. 

j .... dcii U 4t-h the CTSU function as a 

This flag is used during abort cleanup so that the utility 
interlock may be cleared if necessary. 

ptm friaar pf utility interlock) is used to clear 
Subroutine CIN (clear k r uxitiuy in eilh . mit j n() CI n 

the utility interlock. If UIFL is nonzero, subrou i ne CIN 
displays the following message while issuing a CTCU PFU 
function to clear the interlock. 

CLEARING UTILITY INTERLOCK. 
UIFL is cleared by PFU when the utility interlock is cleared. 



Activating PFU for Loading 



Subroutine AUP 



PFU 

I 

f 

d rop 



(activate utility processor) is used to request 
with PFLOAD for permanent tile 



to initiate communication 



dngoadi operations are performed by the CTLm PFU 
unciion ShUn loops until PFLOAD directs it to complete and 




state (FTDL) word in the DATA 
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Subroutine AUP then issues the CTLM PFU function and goes into 
recall on the DATA FET. PFU sets the DATA FET complete when 
load initialization is complete. Subroutine AUP then calls 
subroutine PCT (position on catalog track) to determine what 
files already are present on the catalog track- Finally the 
current EOF position of the permits file is set in RICT from 
the random index returned by PFU in word FTSC of the PETS FET. 

Subroutine DUP (drop utility processor) is used to drop PFU. 
If PFU is active (PAFL is nonzero), subroutine DUP forces an 
EOI write on the catalog track using a call to FCP (finish 
catalog processing). When the DATA FET is complete, subroutine 
DUP sets a 10B request in the FET (drop PFU) and waits for PFU 
to complete the DATA FET and drop from the PFLOAD control 
point. Once PFU has dropped, control is returned to the 
caller. 



Error Process i ng 

This section discusses error processing for the archive file 
and for the mass storage devices being loaded. 



Reading the Archive File 

The archive file is read in control word mode (READCW), 

typically through the use of the CWREAD macro defined in PFLOAD 

This macro calls subroutine CWR (control word read words) to 
transfer data in a manner similar to READW. 



Errors Reading Control Words 

If after issuing a CWREAD to obtain an archive file control 
word, an archive file error status is returned, subroutine RCW 
returns a status that indicates a parity error. The caller of 
subroutine RCW must then process the error appropriately. The 
action typically taken in this error case is to issue an 
appropriate diagnostic and attempt to process the next file by 
doing a skip to EOR (SER) request. 

Similarly, when reading data from the tape, if a parity error 
occurs, an appropriate diagnostic is issued, a skip to EOR is 
done, and the file not loaded. 



Writing the Permanent File 



Subroutine PCE (process catalog errors) is called 
read and write catalog errors. Subroutine PCE is 
subroutines FCW (write) and PCT (read). 



to handle both 
called by 



Subroutine PCE requests PFU to drop if it is active. Once PFU 
has dropped, subroutine SEI is called to set the error idle 
status for the device. Subroutine SEI (set error idle) issues 
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the CTEI PFU function to set the error idle status on the 
device being processed. The utility interloack is then cleared 
using a call to subroutine CIN. Subroutine PCE then generates 
a collection of error diagnostics i dent i f y i ng t he failing 
device and the catalog entries in the sector in error. 

Subroutine PWE (permit write error processor) is called to 
handle errors from permit writes. Subroutine PWE requests PFU 
to drop if it is active. Once PFU has dropped, subroutines SEI 
and CIN are called to set the error idle status and drop the 
ut i I i ty interlock. 

Subroutine PWE then issues appropriate diagnostic messages 
identifying the error condition and the affected file. 

Subroutine DWE (data write error processor) is called to handle 
errors that occur when writing the data to mass storage. PFU 
returns the location of the error (FST at time of error ) in 
word FTPM of the DATA FET. The equipment, track and sector are 
extracted from the FST'into MPEQ, MPTK, and MPSC for use in 
error message formatting. The file name (MPFN), user index 
(MPUI), and device number (MPDN) are also set up for error 
message formatting. An appropriate diagnostic is then issued 
from this information. 

Subroutine DWE calls subroutine SEC (skip through EOI control 
word) to read the DATA file until the circular buffer is empty 
or an EOI is detected. 

The sector count returned by subroutine SEC is used to update 
the file length in the. catalog to include the bad sector but 
nothing following it. The sector count is also used to adjust 
the sector counter for the DATA FET to reflect the amount of 
data removed from the circular buffer. 

If the file is indirect access, the user index in the catalog 
entry is changed to a special write error user index. This 
allows the catalog entry to be kept in the permanent file 
system as a pointer to the bad file. For a direct access file, 
the user index is cleared (creating a direct access hole), the 
appropriate parameters are set in word FTPM of the DATA FET and 
a PFU file position function is issued to drop the track chain 
and flaw the bad track. 

Subroutine SCE (set catalog error code) is called by 
subroutines PPB and PDB to indicate that an error has occurred 
in the permits or data for the file. These error conditions 
are stored in the catalog entry word FCEC. The use of these 
error codes allows a file with errors to be loaded into the 
permanent file system without the danger of the file's owner 
being unaware of the errors. 
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INTERACTIVE FACILITY (IAF) 



37 



INTRODUCTION 

The Interactive Facility (IAF) is a subsystem that provides 
support for interactive processing from remote terminals 
communicating through the Network Access Method (NAM). The 
subsystem consists of the following CPU and PP programs. 



P r og ram 
IAFEX 



IAFEX1 



IAFEX2 



IAFEX3 



Desc ri pt ion 

Time- sharing executive initialization routine. 
This routine is loaded at 40000B relative to 
control point 1 when the operator types IAF. 
It initializes tables and pointers and loads 
IAFEX1 and IAFEX4. 

Time-sharing executive processor. This is the 
main routine that processes I/O for the remote 
terminals. It cracks and processes commands, and 
makes requests to dump source input to disk and 
refill output buffers from disk. 

Performs an optional dump upon termination and 
loads IAFEX3. 

Time-sharing executive termination routine. This 
routine is executed after an abnormal condition 
is detected or when the operator terminates IAF 
with 1.ST0P. 



IAFEX4 
1TA 

1TN 
1T0 



Interfaces IAFEX1 with NAM. 

Auxiliary function processor. This routine 
processes functions for IAF which require PP 
action. 

Communicates between IAF and the NOS stimulator 
(checkout/test) . 

Terminal i nput / output . Called by IAF to 
perform terminal I/O requiring disk accesses. 



The relationship between the various system routines and 
subsystem routines is shown in figure 37-1. 
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terminal 



/ — TnamV* + 



IAF 

Control 

Point 




IAFEX1 



IAFEX4 



1TA ) IAF Assistant 



©Mass Storage 
Terminal I/O 



Figure 37-1. IAF Interactive Subsystem 
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TERMINAL OPERATION 

The flow of data to or from a terminal and a mass storage device 
The tlow ot aaua iu terminal user enters source 

is shown in figure 37-2. The » IAFEX4, 

statements. These « ta ""»"i* 'r , ^'p„, nta t i on, and stored in 
converted to the prope n r ^ r " ^ AFEX4 .' whenever IAFEX4 
pots Ca pot is an eight-word buffer; oy x» ..„,„-, 1t :. sues a 
has filled VIPL pots (defined in common d "* "MSREM) lt >iu.l 
dump pot request. IAFEX initiates t he rou DMP (loca I to 
IAFEX1) which calls 1T0. In the jnt.n. IAFEX4 may have filled 

:^s;%s o i;.r.^: 9 ::%^rcir r .:r l ri:" d n/?". o s"..: n soor 

30 words are written per sector. 



IAF 




Figure 37-2. Terminal Mass Storage Data Flow 
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This continues until the user enters a command that forces a sort 
such as RUN or LIST. If the unsorted file is too large, then the 
message FILE TOO LONG TO SORT is issued. In this case, the user 
must issue the SORT command. 

If, however, the file is rLQ-t; too long, then the terminal is 
placed in sort mode. An ^T0T> job called MSORT is scheduled and 
all users in sort mode are sorted at once. These users are 
queued up until a specified time interval has expired, then the 
MSORT job is run. All the files are given to MSORT in file size 
order, largest first. 

MSORT is an in-memory shell sort. It is started at a control 
point with the FL necessary to sort the largest file. It sorts 
the file and rewrites the file in packed format (that is, 100B 
words per sector). When MSORT has finished a sort, it releases 
FL down to the necessary size for the next file and then sorts 
it. This continues until all the files are sorted. Routine 1R0 
sets all the terminals whose files were sorted to active mode and 
IAF then processes the command that indirectly caused the sort. 



TERMINAL JOB INITIATION 

Refer to figure 37-3 for this discussion. Assuming that a 
user's primary file has been sorted and RUN is entered at the 
terminal, the following events occur. 



1 . IAF bui Ids 
st at ement ) 



a control statement (SLDC or compiler control 
in a pot and calls 1TA. 



2. 1TA builds a rollin queue entry in the system FNT/FST 
area. The FNT entry points to the user's rollout file 
(refer to figure 37-15). 

3. The scheduler, 1SJ, determines that this is the best 

job to initiate, so it assigns a control point and calls 
1RI to roll in the job. 

4. 1RI reads the rollout file to build system FNT entries 
as specified, builds an FNT entry for the primary file 
(input to the compiler), and completes the 
initialization of the control point. 

5. 1RI then calls 1AJ to advance the job which detects the 
SLDC or compiler control statement and loads the 
compiler with sufficient field length to compile the 
source statements. (SLDC is used only to load the 
BASIC compiler.) After compiling, the program is 
executed. As the job executes it may interact with the 
terminal by issuing output and receiving input. 
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© 



IAFEX1 builds a 
control statement 



Read next 

control 

statement 




Figure 37-3. Terminal Job Initiation 
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TERMINAL JOB INTERACTION - OUTPUT 

Refer to figure 37-4 for this discussion. When a terminal job 
writes information to the OUTPUT file, the following events 
oc cur - 

1. CIO is called when the interactive program issues a 
write request to the OUTPUT file. CIO senses that this 
is a time-sharing job (TXOT) and issues monitor 
function ROCM to roll out the control point. 

2. 1R0 initiates the rollout and copies the entire field 
length (including output data) to the rollout file. In 
addition, all FNT entries associated with this control 
point are removed from the system FNT area and stored 
on the rollout file. Prior to calling 1T0, 1R0 saves 
the first sector of output in 1R0's PP memory where it 
can be picked up by 1T0 without additional disk 

i nput /output . 

3. 1T0 is loaded into the same PP as 1R0. The monitor 
function TGPM assigns 1T0 pots into which it writes the 
output data. 1T0 then informs IAF that output is 
available for the terminal by issuing monitor function 
TSEM. 

4. IAFEX1 assigns the data pots to IAFEX4 to the terminal. 
IAFEX4 continues to ask IAFEX1 for additional output and 
IAFEX1 in turn calls 1T0 until all output has been 

t ransf e r red . 

5. After all output is transferred, IAFEX1 calls 1TA to 
reinitiate the time-sharing job. 1TA builds the 
rollin file entry in the system FNT area. 

6. Scheduler 1SJ selects this queue entry as the best job, 
assigns a control point, and calls 1RI. 

7. 1RI rolls the job into the control point and the 
time-sharing job continues to execute. 
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TERMINAL JOB INTERACTION - INPUT 

Refer to figure 37-5 for this discussion. Assuming that the 
time-sharing job is to receive data (input) from the terminal, 
the system performs the following functions. 

1. The job issues a read request on the INPUT file which 

calls CIO. CIO stores the FET address m control point 
area word TINW and issues monitor function ROCM to roll 
out the job. 

2 1R0 is loaded to perform the rollout operation. 1R0 
flags the request in terminal table word VROT and then 
calls 1T0. 

3 1T0 issues any available output and issues monitor 
function TSEM to inform IAFEX1 of the completion of its 
processing. 

4. IAFEX1 calls IAFEX4 to send any output and/or issue the 
input prompt character (a question mark). 

5. IAFEX4 translates the data as required and places it in 
pots. 

6. When the end-of-line is sensed, I-AFEX1 calls 1TA to ; 
reinitiate the time-sharing job. 1TA builds a rollm 
queue entry. 

7. 1SJ selects the queue entry as the best job, assigns a 
control point, and calls 1RI. 

8 1RI rolls the job into the control point and transfers 
the input data from the pots to the job's circular 
buffer. The job is then activated (given the CPU) and 
cont i nues to execut e. 
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Rollin File Entry 



When output has 
been completed, 
IAFEX1 calls 1TA 
to place this job 
in the ROLLIN 
queue 



Control 
Point x 




OUTPUT 



Circular 
Buffer 



Control point x issues a 
write request to the output file 



f~\\D ROCM 

(cxo)---- 



IAF 



terminal M 
tables 



Pots 



TSEM- Assign I/O 
to terminal 



I 



IAFEX4 




Terminal 



Rollout 
Control Point 




Mass 
Storage 



Figure 37-4. Terminal Job Interaction (Output) 
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Control 
Point x 



Roll in queue 
entry this job 



Control point x issues 
a read on the input file 



Terminal 



Rollout 
Control Point 




Mass 
Storage 



Figure 37-5. Terminal Job Interaction (Input) 
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INTERACTIVE JOB NAMES 

Whenever a job is initiated at a control point, 1TA generates 
job name based on terminal number and user index of the user. 

The common deck COMP6JN (generate ^V^fU^hv^PO th^iob 
task. Whenever a job is rolled back to AFE 1 R0 ' th * J ob 
name must be decoded back to the terminal number Routine 1R0 
uses the common deck COMPGTN (generate terminal number) for 
task. In this way, 1R0 knows the terminal table in which to 
indicate the rollout back to IAFEX. The termi na I number is 
into the fifth through seventh characters of the job name, 
user index is coded into the first thru fourth characters. 



thi s 

coded 
The 



INTERACTIVE COMPASS PROGRAM EXAMPLE 

The following program demonstrates how an i nteract i ve COMPASS 
program could be structured. 



OUTPUT 

OUTBUF 

INPUT 

INBUF 

IN 

SETUP 

START 



IDENT 

ENTRY 

FILEC 

BSS 

FILEC 

BSS 

BSS 

VFD 

SA1 

BX6 

SA6 

BX6 

SA6 

WRITEC 

READ 

READC 

WRITEC 

WRITER 

ENDRUN 

END 



INTER 
START 
OUTBUF, 101B / FET=6 

101B 

INBUF, 101B,FET=6 

1018 
16 

42/0L0UTPUT,18/0UTPUT 

SETUP SET FET POINTER FOR BUFFER 
FLUSHING 

X1 

2 

X6-X6 TERMINATE FILE LIST 

3 

OUTPUT, ( = C* THIS PROGRAM INTERACTS.*) 

INPUT 
INPUT, IN 
OUTPUT, IN 
OUTPUT 



START 
The following demonstrates how the program is executed. 

o Id, i nt erf 

READY, 
batch 
$RFL,0. 
/ compass, i = int erf , 1 = 

1.008 CPU SECONDS ASSEMBLY TIME. 

/ Igo 

THIS PROGRAM INTERACTS. 
? please repeat after me... 
PLEASE REPEAT AFTER ME... 
LGO. 
/ 
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IAFEX INITIALIZATION 

IAFEX initializes 



tables and pointers, then loads 



Basically, J^« 1 J"" 'il"! AFEX /the main routine. PP 
^1-^ includ. the following. 



p rog ram 


CIO 


CPM 


LOR 


PFM 


1TA 


1TN 



Desc ri pt i on 

Combined input/output 
Control point manager 
Load overlay 
Permanent file manager 
Auxiliary function processor 
Stimulated terminal driver 




this file are 



f o I lows . 



•RETURN PROCEDURE FILE IAFEX. 

RETURN, IAFEX. 

WHILE, TRUE, LOOP. 

IAFEX. 

IAFEX2. 

SKIP, LOOP. 

EXIT. 

IAFEX2. 

END IF, LOOP. 

ENDW,L00P. 



Init 
poi n 
37-1 



iali zat ion consists o 
ters shown in f i gure 3 



f allocating tables, establishing the 
37-6 and the constants shown in table 



T^hTchTracters ffff are optional; if ^^11^^^?^ 
personnel must supply the one to four alphanumeric characters 

to be used . 
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RA+3 



+4 




+ 5 



first network terminal number 



last network 
terminal number 



fwa message status table 



fwa network activity table 

V. 



lwa+1 message 
status table 



lwa + 1 network 
activity table 



+ 10 



+ 11 




VTTP 

VNTP 

VMST 

VNAT 

VPLP 

VCTP 

VBMP 

VWMP 

VRAP 

VPTP 

UTRN 

DBUG *1 

VFNL 



•1 Driver debug word. 

*2 Useful in debugging 1TD 



Figure 37-6. Pointer Addresses 
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59 



RA + 20 



+ 21 



+ 22 



+ 23 



+ 24 



+ 25 



+ 26 



+ 27 



+ 30 



+ 31 



J: 



47 23 



number of times had to wait for PP 



total users since initialization 



current active user count location 



maximum number of possible users 



new available pot count during FL change 



negative indicates no reload 



real-time clock at last recovery 



abnormal occurrence counter 




V 



minimum number spare pots 



maximum number spare pots 



number of pots allocated (available) 



number of pots in use 



VPPL 



VTNL 



VANL 



VMNL 



VCPL 



VRLL 



VABL 



VPLL 



VPAL 



VPUL 



Figure 37-6. Pointer Addresses (Continued) 
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RA+32 




VTRP 



VTGP 



VTEO 



VDRL 



Figure 37-6. Pointer Addresses (Continued) 
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TABLE 37-1. IAFEX CONSTANTS 
Va Cue | Desc ri pt i on 



Constant 



MSORFL 
VBFL 
VBPL 
VBPT 

VBTL 

VCPC 
VCPT 
VDSL 
VIPL 

VMPL 

VMTO 

VNPL 
VNTL 

VNTO 

VOPL 
VRBL 
VSBL 
VSPL 

VTGL 
VTRL 
VXPL 
UTIS 



4 

2 
3 

12B 

10 
1 

100 
2 

40 

10D 

4 
13B 

20D 

4 

20 

VTEQ- 
VTGP- 
20B 
10 



■VTGP 
■VTRP 



MSORT base FL 

Default BATCH subsystem FL 
Maximum ABL for Low speed tines 
Additional PLT words per high-speed 
line 

1TO call time delay for high-speed 
lines (one second) 
Number of words per pot 
IAF control point number 
Length of driver circular queue 
Number of allowable source pots before 
dump 

Maximum number of spare pots per 64 
use rs 

Multiplexer terminal SALVARE file time- 
out value (minutes) 
Minimum number of pots for network 
Default 1T0 call time delay (two 
seconds) 

Network terminal SALVARE file time-out 
va lue (mi nutes) 

Number of pots issued for multiplexer 
Reserved 
Reserved 

Minimum number of spare pots per 64 
users 

Length of monitor TGPM queue 
Length of monitor TSEM queue 
Maximum number of pots for network 
Default user time limit/10 



The following are VR0T status bits used with 1R0 



VJIR I 


1S1 




VRIR I 


1S2 




VIPR I 


1S3 




V0PR 


1S4 




VECS 


1S10 




MAXTT 


1024D 




MPLT 


120B 




WCQT 


100 




LIAA 


4 




CBASE 







LISDL 


2 




C0MDL 


6 




EXEDL 


|5 




CATDL 


|5 




S0RDL 


|2 




BATDL 


|4 




RESDL 


|4 





Job in system 

Job to be rolled in again 

Input requested 

Output avai lab le 

Job uses ECS 

Maximum number of terminals 

Number of PLT words per 64 users 

Wait completion queue delay time 

(msec . ) 

Login attempts allowed 

Default base for command parameter 

(octal) 

List delay time 

Compi le delay t i me 

Execute delay t i me 

CATLIST delay time 

Sort delay time 

Batch del ay t i me 

Resequence delay time 
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TABLE 37-1. IAFEX CONSTANTS 
(Continued) 



(Constant I Value I 



Description 



SWPDL 


|0 


NULDI 


|10 


BASDI 


1. 4 


FTNDI 


K 


TRAD I 


I '-- 


EXEDI 


I A 


BATDI 


|5 


ACCDI 


no 


SYSDI 


|3 



I Swap-in delay time 
Null input response delay time 
[BASIC input response delay time 
IFTNTS input response delay time 

i^ut.Vut response delay^time 
Batch input response delay time 
|Access input response delay tim 
iSystem processed commands _ 
iSALVARE file time check Cmins. 



me 



37-15.1 
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The following illustrates the multiplexer table. Anentr 
exists for each stimulated multiplexer in the EST which i 
plus an entry for the network interface. 



on 



MUXP 



59 


47 


35 


23 


11 


channel 





number of ports 





first port 



After 
IAFEX1 
ope rat 
comp le 
the wa 
Next, 
system 
of sue 
t he co 
INITIA 
set t in 
like c 
ve ri f y 
IAFEX 



i ni t i al i 
and IAF 
i on def i 
te statu 
rning me 
IAFEX ca 
. The jo 
h jobs i 
unt is n 
LIZATION 
g FIRST, 
i rcu la r 
i ng the 
i s comp I 



zi ng the 
EX4 code 
nit ions . 
s by sett 
ssage add 
Us 1TA t 
bs search 
s returne 
onzero, I 

ABORT. 

IN, OUT, 
buf f e rs . 
recove ry 
ete and c 



tab le 
which 
Next 
i ng V 
ress 
o sea 
ed f o 
din 
AFEX 
Next , 
and 
F i na 
f i le 
ont ro 



s, IAF 
use t 
, each 
ROT eq 
VWMP i 
rch f o 
r are 
a pseu 
aborts 

each 
LIMIT. 

Uy, a 
CSALVx 
I is t 



EX modifies addresses in 
he increment instruction 

terminal table entry is set to 
ual to 3 in each entry. Next, 
s set to the normal header, 
r time-sharing jobs in the 
TXOT and MTOT type. The count 
do terminal table for IAFEX. If 

with the' message: IAFEX 
driver queue is initialized by 

The driver queues are used 
fter starting the drivers and 
x, where xx is the machine ID), 
ransferred to IAFEX1. 



IAFEX1 - MAIN PROGRAM 

IAFEX1 is the main program that controls and coordinates the 
time-sharing subsystem. This program is driven by the following 
queues . 



Request entering IAFEX: 
Queue 



Desc ri pt i on 



Driver request Requests from 1TN and IAFEX4 

Monitor request Requests from other PPs 

Monitor pot request Requests from other PPs for pots 



Internal cont rol : 

Queue 

Wait comp le t i on 
Time de lay 
Job 

Sort 



Desc ri pt i on 

Wait for completion of a process 

Wait for time to elapse 

Wait to do all job scheduling at 

onetime 

Wait to do all sort scheduling at 

one time 
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Re 



quests sent by IAFEX: 



Queue 

1 TA 
1T.0 



Desc r i pt ion 

Send all 1TA requests at one time 
Send all 1TO requests at one time 



_■ i_ ♦. u « TAPPV1 control loop which is 
These queues are scanned by the IAFEX1 conxro 

defined in the flowchart of figure 37-r. 
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mafV— 

DRI 

process driver 
queue 



URT 



update 
running time 



STR 



process system 
IAFEX 
requests 



RPC 



refill pot 
chain queue 



TDQ 



process time 
delay queue 



CSF 



check 

SALVARE 

file 



SOR 



process sort 
queue 



SCH 



schedule jobs 



TSH 



check for 
request 
completions 



PPU 



process PP 
requests 



1 AFEX4/ND R 

execute 
network 
interface 



SPR 



check for 
FL change 
necessary 



EPP 



enter PP 
requests 



ML 



process driver 
queue 



STR 



process system 
IAFEX requests; 



RPC 



refill pot 
chain queue 



I 



RECALL 



IAFEX 
in recall 



*1 The SALVARE file contains a two-word entry for each user in 
recovery state. 

Figure 37-7. IAFEX1 Control Loop 
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,. l. oAiv/ADC -f-iip entries are checked and if the 
Every 3 mi nut es the SALVA RE f i Le e ntri es ed he roLLo ut 

time is over VNTO minutes old, t. t dropped, and the 
file and all ™ n * e ™ a ™" ^ ° rs mus recover within VNTO minutes 
terminal Logged off. T p U A S Ue entry will be eliminated, 
of system recovery or **e SALVABE^ J^ e y ALVAR£ . IAFEX 
The SALVARE file is discussed further unae. 



Recovery File in this section. 

The relationship between processing 

in figure 37-8. 



mo 



dules of IAFEX1 is shown 



Queues 



r 



Tables 




Control Loop 



PCS 



1 



Queue Processor 



I 



Request Processing 
Routines 




Command 
Processor 



Subroutines 



Figure 37-8. IAFEXl Processing Modules 

Tn aeneral all tables in IAFEX are dynamic in length at 
JniHatizUion time. The lengths of the various tables and 




figure 37-9 . 
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RA 

RA+77B 

VTRP 

RA+MUXP 

TRQT 

PCOM 



TCOM 



TRRT 



IAFEX1 { 



PBUF, 
SBUF 



TRANC 
VDRL 

VTTP 
VRAP 
VPTP 
VPLP 
VBMP 
RA+FL 



Table, queue, and buffer 
pointers set at initialization 



Statistics 



TSEM and TGPM queues 

Network interface and 
multiplexer table 



Queue table 



Subsystem table 



Driver request queues 



Character translation tables 



Terminal table 



Reentry table 



Reserved 



Pot link table 



Pots 
(8-word buffers) 




EXI8UF - load address 
for IAFEX2 (the exit 
processor) 



^ 



Coded routines 



Figure 37-9. IAFEX1 Memory Map 
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DRIVER REQUEST QUEUE (S) 



Driver requests are passed to IAFEX1 via the driver request 
queue which are circular stacks as shown .in figure 37-10. 



FIRST 




LiM 



,t 



driver request queue entries 
(one word each) 



I 



100B 
words 



Figure 37-10. Driver Request Queue Stack 

Driver request queue entries are placed in a circular stack by 
the driver.* The IN pointer is updated by the driver when an 
entry is placed into the queue. IAFEX1 updates the OUT pointer 
as the driver requests are completed. The driver name is stored 
in word 1 with a pointer to the next stack A zero pointer 
indicates the last stack. Each stack is 105B words in length 
C100B words for entries plus five header words). A maximum of 
four stacks may exist; one for each driver. The entries are one 
word as f o I lows : 



59 



2000+rq 



47 



35 



23 



11 



P2 



P1 



tn 



Request number 
Pa rameter 2 
Parameter 1 
Te rmi na I number 



*The driver is either IAFEX4 when no STIMULA-type terminals are 
being used or IAFEX4 and/or 1TD if STIMULA is in use. 



rq 
p2 

p1 
tn 
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The request number is always biased by 2000B so that a jump 
table index can be stored in a B register with use of the unpack 

f the above word is m X2, consider 



instruction. For example, 
the following instruction. 

UX1,B7 X2 



X1 



The result is that B7 contains the request number and 
contains the parameters and terminal number (that is, the lower 
48 bits). A list of request numbers < request codes; is 
maintained in common deck COMSTDR and are listed in table 37-2. 

TABLE 37-2. DRIVER REQUEST NUMBERS (ISSUED TO IAFEX1) 



| Request I 






| Code I 


Symbol I 


Description I 


i I 

I o I 


AOD I 


Increment retry count 


I 1 I 


CSC I 


Circuit scan complete 


I 3 1 


CLI I 


Command line input, Pl=first pot, 
P2= word in pot 


I ^ 


DLO ! 


Data lost, P2=type 


j 5 


DRP 


Drop pot 


1 6 


DRT 


Drop pot chain, Pl=first pot 


| 7 


HUP 


User hung up phone 


| 10 


IAM 


Issue accounting message, P2=type 


| 11 


LOF 


Log off user 


I 12 


LPT 


Request additional pot, P1=current 
pot 


| 13 


MAL 


Reserved 


I 14 


MTN 


[Reserved 


I 1 5 


| RES 


[Request more output, P1=current pot I 


I 16 


RIN 


Release source line, Pl=first pot I 


I 17 


| SAI 


|Set autoinput mode 


! 20 


j SKY 


[interrupt from terminal, P2 = interrupt I 
| leve I 


I 21 


| SPT 


| Rese rved 


! 22 


| SSC 


| Rese rved 


I 23 


I TTI 


| Rese rved 


I 24 


| EMO 


| Rese rved ' 
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MONITOR REQUEST QUEUE(S) 

PR requests for IAFEX -processing are handled via the PP *°ni« r 
function TSEM. The message buffer is set up by the requests 

PP according to the following format. 



59 



2000 + fn 



p1 

fn 



- p4 



47 



35 



23 



11 



Pi 



P2 



P3 



p4 



Parameters depending on the function. 

Function code. These function codes are defined 
in packed format in common deck COMSREM. They 
are listed in table 37-3. 

TABLE 37-3. TSEM MONITOR REQUEST FUNCTIONS 



Value ! Name 



Desc ri pt i on 



2000 

2001 

2002 

2003 

2004 

2005 

2006 

2007 



VDPO 
VASO 
VMS6 
VSDT 
VCDT 
VSCS 
VPTY 
VSBS 



Drop pots 

Assign output 

Terminal message 

Set terminal table bit (VSTT only) 

Clear terminal table bit CVSTT only) 

Set character set mode 

Reserved 

Set subsystem 



f ree 



PP monitor picks up the above request and stores it in a Tree 
stot in the IAFEX monitor queue for TSEM functions. This queue 
is located at VTRP in IAFEX and is 10B words in length. If no 
stot is free in this queue, monitor (MTR) keeps trying until 
IAFEX honors an existing request and clears a slot. 

In qeneral, IAFEX drops any unused pots in the chain. If the 
Las? pot s not completely filled by the routine issuing output, 
tie routine must pu? in a terminator byte (0014) in the output 
data except when network ASCII data has been generated, since 
this mode has a character count in the data header. 

NOTE 

When issuing a 2001, terminal status must have 
bit 4 set in VR0T. 

Pots for output are obtained by issuing the monitor function 
TGPM. These requests are handled by IAFEX in a 3-word queue 
similar to TSEM requests. 
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The parameters for the various functions are defined as follows 
V QPQ - Drop Pots (IAFEX1 Routine DRT) 



59 



2000 



47 



35 



23 







yyyy 



xxxx 



11 



nnnn 



yyyy 

xxxx 
nnnn 



Last pot to be dropped 
First pot to be dropped 
Te rmi na I number 



ASO - Assign Output (IAFEX1 Routine ASO) 



59 



2001 



47 



35 



23 



yyyy 



xxxx 



11 



nnnn 



yyyy 

xxxx 
nnnn 



Last pot of output 
First pot of output 
Terminal number 



SCS - Set Character Set Mode (IAFEX1 Routine SCS) 



59 



2005 



47 



35 



23 



yyyy 



xxxx 



11 



nnnn 



yyyy 

xxxx 

nnnn 



Last pot containing mode 
First pot containing mode 
Terminal number 
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VSB 



S - Set Subsystem CIAFEX1 Rout i ne „SB_Sj_ 








nnnn 



yyyy 

X XXX 

nnnn 



Last pot containing subsystem 
First pot containing subsystei 
Te rmi na L number 



VMSG - tc. ^n Message (IAFEX1 Rout ine DSD) 



59 



2002 



47 



35 



23 







yyyy 



xxxx 



nnnn 



yyyy 

xxxx 
nnnn 



Last pot of message 

First pot of message 

Terminal number; if below maximum number of 

pseudo terminals, then this is a warning message 

sent to all terminals 



VMSG is used by DSD to process the DIAL and WARN operator 
c ommand s . 
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VSDT and VCDT TSEM Requests 



When a 
that p r 
(refer 
di sab Le 
i n sect 
gene rat 
appropr 
termina 
this f i 
The ena 
spec i f i 
table V 
c omp Le t 



terminal u 
og ram with 
to the IAF 
/enab le th 
ion 12 of 
es an RA+1 
iate TSEM 
I i nterrup 
eld and s e 
b le f unct i 
ed in the 
STT. Refer 
e desc ri pt 



se r initiates 

te rmi na t i on 

Reference Ma 

i s f unc t i on h 

the NOS Refer 

call to the 
request (func 
t address in 
t s the di sabl 
on sets this 
call and c lea 

to volume 2 
ion of DISTC. 



he may terminate 
(UB2) sequence 
user wishes to 

macro desc r i bed 
2 . This macro 
i ssues the 
which sets the 



a CPU program, 
or user b reak 2 
nual). If the 
e can use the DISTC 
ence Manual, volume 
PP routine TLX. TLX 
tion 2003 or 2004), 
TIAW. The disable function ignores 
e bit in the terminal table VSTT. 
field to the address relative to RA 
r the disable bit in the terminal 
of the reference manual for a 



TGPM Reques t 

Pots for output are obtained by issuing the monitor function TGPM 
The requests are handled by IAFEX in a 3-word queue similar to 
TSEM requests. The call to TGPM is as follows. 




Upon return, the OR is as follows. 
59 47 35 
OR 




p ppt pointer (0 if no pots available) 

If p=0, the PP should reissue the request. 

Whenever a PP needs a pot chain it issues the TGPM MTR request. 
MTR searches the IAFEX TGPM queue for a nonzero entry. If MTR 
finds one, it will be the first pot of a pot chain. The chain 
size is an assembly constant and is currently fixed at 4 pots. 
This pot chain is assigned to the calling PP and the queue entry 
is zeroed. If the queue is empty, MTR issues 



an RCLM on IAFEX. 



During IAFEX* s main loop it checks the TGPM queue and if it 
finds any empty entries, it generates a pot chain and places the 
first pot number in the queue. 

The TGPM is used by 1T0, which requests pots for flushing a TX0T 
type job's OUTPUT file. Another user is DSD, who must get a pot 
chain for the WARN and DIAL messages. 
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TERMINAL TABLE 

The terminal table contains an eight-word entry for each 

poss b le active user. Each entry contains the current status of 

connection. These eight-word entries are s rue ure in such 
a way so as to minimize interlocks between IAFEX1 and the various 
PP routines which read and write them. 

TAFEX4 and the network terminal processing 

terminat tables VFST, VDPT, and VCHT to ..Int.m t.r-in.l 

operations parameters. 

Word (VUIT) is written by IAFEX and 1TA and read by IAFEX and 
1TA* Its format is as follows. 

17 



rout i nes of 1 TO use 



59 



user number 



user index 



Word 1 (VFNT) is written by IAFEX, 1R0, and 1TA and read by 1RI, 
1TA, IAFEX, 1R0, and the driver. Its format is as follows. 



59 



mode 
bf I 



17 11 



primary file name 



mode 



bfl 



Write lockout if bit set; execute only if bit 

RFL%alue for batch subsystem; sector count for 
1TA on RUN, I=lfn 



Word-2 CVFST) is written by IAFEX, 1R0, 1TA, 1RI, and 1T0 and is 
read by IAFEX, 1R0, 1TA, 1RI, and 1T0. 

VFST is used by 1T0 to maintain ^atus information between 
output operations involving an output line that has been spl 
Across pot chains. This word uses the VROT i nter loc k; t h.t , 
when VROT is interlocked, 1T0 may write word VFST. Its format 



as follows. 




35 



23 



11 



1st track 
primary file 



current 
track 



QQ 



status 



le 
pe 



List file equipment number 
Primary file equipment number 
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aa 



status 



One of the following: 

• List or primary file current sector 

• Control statement pot pointer during job 
scheduling 

• Accounting pot pointer during logout 
Output status bits: 

B i t Desc ri pt i on 

11-6 Unused 

5 Line cont i nuat i on 

4 7400 escape character 

3 7600 escape character 

2 Binary 

1 Transparent 

Extended 

Word 3 CVROT) is written by IAFEX, 1R0, 1T0, 1RI, and 1TA and is 
read by IAFEX, 1R0 / 1RI, 1TA, 1T0, and the driver for the rollout 
file. Its format is as follows: 



59 


53 


47 


35 


23 


11 


word 
cnt. 


est 

rollout 

file 


1st track 
rollout 


a 


field 
length 


substatus 


status 



a Absolute FL flag; if not set, then FL i 
100B 



s in units of 



Bit 



substatus: 

File list if (list with EOR and EOF if 1) 

J ob Status : 
Meaning 



Leve I numbe r 

SRU limit 

Time limit 

Terminate special job 

with FL 
Terminate special job 
I nt e rrupt 
Input status 

EOI 

EOF 

EOR 



23-2 


19 


18 


17 


16 


15 


14 


13 


12 
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status: 

I AFEX i n cont ro I 

System in control. 

Job in system 

J ob to be rol led i n 

Job awaiting input 

Output avail able 

Special system job 

List 

Multi-terminal 

Suspended 

Not used 

Error on last operation 



Bit 



Va lue 






1 








1 





2 


1 


3 


1 


4 


1 


5 


1 


6 


1 


7 


1 


9 


1 


10 




11 


1 



Word 4 (VDPT) 
rout ines of 1 TO 
format i s as 



is used by IAFEX4 and the network processing 
to maintain terminal operations parameters 
f o I lows . 



Its 




f w Fi rst word of f i rsf pot 

wc Last pot word count 

flags Each bit defined as follows: 

Description 

Unused 

Source input initiated 

Binary input 

Transparent input 

Unused 

word 5 CVCHT) is also used by IAFEX4 and the network processing 
routines of 1T0 to maintain terminal operations parameters. Its 
format is as follows. 




59 


47 


35 


23 


11 o 


ad 


X7 


83 


ic 


oc 



ad 
X7 
B3 
i c 
o c 



Reentry address relative to NDR 

12-bit X7 parameter 

B3 parameter; assumed to be pot pointer 

Input character count 

Output character count 



Word 6 
format 



(VOCT) is written and read by IAFEX1 and IAFEX4 
is as f o I lows . 



Its 
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11 







flags 



term 



num 



ace 



next 



flags Flags as follows: 
Bit Value Meani ng 



Tape mode 

Auto mode 

Text mode 

Extended mode 

Reserved 

Reserved 

Read data mode 






0001 


1 


0002 


2 


0004 


3 

4 


0010 


5 
6 


0100 


7 


0200 


8 


0400 


9 


1000 


10 


2000 


11 


4000 



term 



Input requested 

User logged in 

Interrupt comp lete 

Driver request from IAFEX1 byte 4 

Terminal control information as follows: 



Bi t va lue 
11-3 -- 
2-0 0-7 



Meani ng 
Not Used 
First word of output line in 



pot 



num 



ace 



next 



Word 7 
IAFEX4, 



In AUTO mode, the line number increment 

Access control flags (lower 12 bits of access word 
defined in VALIDUs file for this user). Refer to 
the N0S installation Handbook for procedures to 
establish the access word. Refer to section 20 
for a description of the bits currently defined 
for the access control word. 

First pot of an output message assignment or 
driver request function code (byte 0, bit 59 
flag). (Refer to BGI - STT Subroutines). 

(VSTT) is written by IAFEX1 and is read by IAFEX1, IAFEX4, 
1T0, 1 RI , 1R0, and DSD. Its format is as follows. 



59 




47 




35 


23 




11 




O 


flags 


first 


cmand 


sys 


pot 
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f Lags 

Bi t 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

f i rst 



Flags as f o I Lows : 



cmand 



sy s 



pot 



Val ue 

0001 

0002 

0004 

0010 

0020 

0040 

0100 

0200 

0400 

1000 

2000 

4000 



Meam ng 

Log-out in progress 

Unconditional abort flag 

Warning issued 

Run complete message 

Sort flag 

Not Used 

job complete flag 

input lost or job not started 

Not used 

Charge number required 

Conditional abort flag 

Disable terminal control 



First pot of source line input, 
with byte 2 (pot count), is used 
to dump pots to disk as input is 
calling 1T0. 



This byte, along 
in subroutine DMP 
recei ved by 



Pot count or index into command table, TC0M. The 
index is set by subroutine SCT. Also may be used 
as DSD command pointer. 

Bits 23-15 nonzero if files lost on RECOVER 
command BUs 14-12 are current system in control 



Null 
BASIC 



FTNTS 

Execute 

Batch 



Access 



Pot pointer to a queued output message. That 

/ ssage is already in VDCT and not /e 
processed, the next message is queued by usm 
byte 4 of VSTT. If another message must be 
assigned, it will be lost. Refer to subroutm 



i s 



ASM. 



Normally, this byte is zero. 
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Table 37-4 is a summary of the terminal table entry. 
TABLE 37-4. TERMINAL TABLE ENTRY SUMMARY 



Name 



VUIT 
VFNT 

VFST 

VROT 

VDPT 
VCHT 
VDCT 
VSTT 



Word 



Written by 



Read by 




IAFEX, 1TA 
IAFEX, 1R0, 1TA 

IAFEX, 1RI, 1R0, 

1TA, 1T0 
IAFEX, 1RI, 1R0, 

1T0, 1TA 
IAFEX4 
IAFEX4 

IAFEX, IAFEX4 
IAFEX 



IAFEX, 1TA 
IAFEX, 1RI, 

IAFEX4 
IAFEX, 1RI, 

1TA 
IAFEX, 1RI, 1f 

1TA, IAFEX4 
IAFEX, IAFEX4 
IAFEX4 

IAFEX, IAFEX4 
IAFEX, 1RI, 1R0, 

IAFEX4, 1T0, 



1R0, 
1R0, 
1R0, 



1TA, 
1TO, 
1T0, 



DSD 



1TA, 



the name IAFEX refers to any of the overlays 

routine which writes a word 



IAFEX4. Any 



In table 37-4, 

comprising IAFEX except 

also is assumed to read that word. 

NETWORK TABLES 

IAFEX4 uses two dynamic tables in addition to the nonnetwork 
tables. These tables, the message status table (VMST) and the 
network activity table (VNAT), are allocated only if network 
t ab les are def i ned . 



The message status table VMST contains network terminal control 
information and supervisory message pointers. Its format is as 
f ol lows . 



VMST 



35 32 29 



22 17 








spvp 



f lags 



Each bit defined as follows: 



Bi t 

59 
58 
57 
56 
55 
54 
53 
52 



Desc r i pt i on 

Te rmi na I on- li ne 

Suspend t raff i c 

B reak in p rog ress 

Shutdown warning sent 

End-connection in progress 

Data received previous cycle 

MSG block sent (input enabled) 

Data present on NAM (used only during 

break processing) 
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dt 
be 
bl 
np 
spvp 



Device type 

Unacknowledged downstream block count 

An-nlication block Limit 

pots allocated for output pot strmg 
Pot pointer of pot containing supervisory rcessage 



which network terminals 




Igo ri t hm 



w - 



( tn - ft ) / 32 

Word location relative to start of table 



w 

tn 

ft 



Terminal number 

First network terminal number 



rb ' C tn -ft ) mod 32 

rb Bit location relative to bit 59 

POT LINK TABLE 

The pot link table (PLT) controls the use of pots C8-word 

buffers). Its layout is as follows. 



VPLP+O 



+ 1 



byte 



7777 



byte 1 



0002 1 



0005 4 



+ 2 



0000 10 



0012 11 



1 

1 



byte2 byte 3 



0003 2 



0000 5 0007 6 



0013 12 



0004 3 



0000 7 



0014 13 



byte 4 

n 



001 



0017 



0007 



1 
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Byte 4 contains reservation flags in the following format 



11 



OOO 000 001 

A 



111 

AAA 



— pot in byte 3 reserved-, 0= free pot 

— pot in byte 2 reserved; 0= free pot 

— pot in byte 1 reserved-, 0=free pot 

— pot in byte reserved; 0=free pot 



Each byte (0-3) represents a pot, an 8-word CM buffer starting 
at VBMP. Bytes 0-3 contain a link to the next pot in the chain. 
The last pot in the chain is indicated by a zero byte. Pot zero 
is always reserved and Links to 7777. Each PLT byte has the 
following format. 



11 




2 1 





word link 


t 


, 













1 — byte link 
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I 

c 
p 
be 



„ th . precedin g table, PO- 1 "5 ? re ^reso rved and co.prl.. on. 
IVX <?\l.\"%' o C r&\?.SW.K: Reserved chains need not 



cont i guous 



INTERNAL QUEUES CTRQT) 

uuiir at assembly time in a table of 
ALL internal queues are built at J 53 *™^ es that may have 

?—:;. ; h ;: h r b n.:.:°r n /;:o;.: f ti ----- 

valid queue names in the table of queues. 



Name 

WCMQ 
TIMQ 
JOBQ 
SORQ 
I TAG 
ITOQ 



Desc r i pt i on 

Wait completion queue 

Time delay queue 

Job queue 

Sort queue 

1TA queue (PP request queue) 

1T0 queue (PP request queue) 



he PP request queues are one-word entries i 
ueues, while the other 4 are two-word entn 



T 

q 
the 



in the table of 
es. The format 



of 



entries is as 



59 



f o I lows . 
41 35 



23 



PPP 



fc 



tn 



PP 



PPP 

f c 
tn 
PP 

59 



2ccc 



c cc 
nnnn 

yyyy 

tt . ... t 



1TA, 1T0 
Function code 
Terminal number 
Pot pointer 



47 



35 



29 







17 



nnnn 



yyyy 



tt . . . t 



Number of entries (packed format) +a u l( ^ 
First terminal entry (index into reentry table) 
Last terminal entry (index into reentry table) 
Resource control count 



NOTE 

Each queue has an associated string of 
entries in the reentry table. 
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REENTRY TABLE (VRAP) 

The IAFEX subroutines use the reentry table to have 
returned or functions performed for them when a set 
conditions are met. The table consists of one word 
terminal with one of the following formats. 



59 



contro I 

of 

for each 



No reentry conditions 
59 47 



23 



11 



2yyy 



xxxxxxxx 



PPPP 



nnnn 



yyy Index to TRRT (table of reentry processors) 

xxxxxxxx Anyt hing 

Pot pointer for further parameters 

Link to next entry in the queue of this type (see 



PPPP 
nnnn 



59 



TSR) 



17 







nnnnnn 



nnnnnn 



Pot address of stacked entries 



Each entry in the reentry table contains an index to the table 
of reentry routine parameters (TRRT). 

TABLE OF REENTRY ROUTINE PARAMETERS (TRRT) 

This table is built at assembly time. It consists of entries 
that direct further processing based on entries from the reentry 
table and on completion of certain sections. Entries are added 
to the table by use of the COMMND macro. Entries are one word, 
according to the following format. 



59 



TRRT 



xx 



53 



47 



35 



17 







yy 



zzzz 



eeeeee 



nnnnnn 
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X X 



yy 

z zzz 

eeeeee 

nnnnnn 



Index to TRQT (queue table); if xx=0 / no 

resources are required except for a peripheral 

processor, possib L.y . 

Function code for called program noonr 

Function processing address relative to TSRPROL 

Error return address 

Normal return address 



The COMMND macro format is as follows 



LOCATION 



OPERATION 



COMMND 



VARIABLE SUBFIELDS 



proc ,sysr, npr o , err a , f unc 



p roc 
sy s r 

npro 

erra 
f unc 



Entry point of routine to process this, command 

The queue that the request is to be placed in: 

WCMQ, TIMQ, JOBQ, SORQ, ITAQ, or ITOQ (xx) 

Normal return address (nnnnnn) 

Error return address (eeeeee) 

Function code to be passed to the called program 

(yy) 



The following example uses the COMMND macro to generate a queue 
ent ry . 

COMMND INP6,WCMQ,INP6,INP6 ^ MMM * 

EQU * (This is generated by the COMMND 



INP6$ 



mac ro) 



INP6S is the symbol for this word in the table of reentry 
rout i nes . 

Now to make the WCMQ queue entry: 



SX5 

EQ 



INP6$ SPECIFY COMMAND TABLE ENTRY 
PCS4 MAKE QUEUE ENTRY 



INP6 BSS 



NORMAL AND ERROR RETURN ADDRESS 



In general, queue entries a 
IAFEX. 



re made in this manner throughout 
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Figure 37-11 shows the relationship between the table of queues, 
the reentry table, and the table of reentry routine parameters. 
There is one queue entry per terminal. 



QUEUE PROCESSING 



l s 



done by the PCS subroutine. As 




bits as shown) 



Regi ster 


AO 


B2 


B3 


B4 


X7 



Desc ri p t ion 

FWA of user's terminal table entry 

Terminal number (bits 11-0) 

Pot pointer (extracted from byte 3 of entry 

in reentry table) (bits 47-24) 

FWA of pot pointed to by B3 (B3*10+VBMP) 

Bits 47-24 of reentry table entry 



These A and B registers are generally not changed within the 
various subroutines of IAFEX. 
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word 1 of WCMQ from TRQT 
59 47 



VRAP 




TRRT 



TRQT 
index 



func. 
code 



function 

processing 

address 



error return 
address (code) 



set up by 
normal return COMMND 

address (code) macro 



Figure 37-11. Table Relationships 
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IAFEX ROUTINES 

The following is an outline of the subroutines comprising IAFEX1 

• MUXP - Multiplexer table (RA + 101B) 

• TRQT - Table of queues: 



WCMQ 


ITAQ 


TIMQ 


ITOQ 


JOBQ 


PFMQ 


SORQ 





IAF - Control loop; calls the following: 



STR 



PCM 



CSF 
DRI 
EPP 
NDR 



PPU 
RPC 
SCH 
SOR 



SPR 
STR 
TDQ 



TSR 
URT 



- Process requests to handle output to terminal by 
calling the following subroutines: 



ASO 
CDT 
DRT 



DSD 
PTY 
SBS 



SCS 
SDT 



CSF - Checks SALVARE file user time out 

DRI - Process driver (1TD) requests by calling the 
following subroutines-: 

TTI 



AOD 


DLO 


HUP 


MAL 


SAI 


CSC 


DRP 


IAM 


MTN 


SKY 


CLI 


DRT 


LOF 


RES 


SPT 


DIN 


EMO 


LPT 


RIN 


SSC 



- Process terminal commands (called from CLI, AUT); 
calls following subroutines: 



ACC 


DIA 


LIS 


REP 


SUB 


ASC 


EDI 


MTR 


PER 


TAP 


ATT 


FDP 


NOR 


ROT 


TER 


AUT 


GET 


NOD 


RUN 


TXT 


BAT 


HEL 


NOS 


SAV 


UNS 


BIN 


HDP 


PAC 


SOF 


UNU 


BYE 


LAN 


PAR 


STA 


XEQ 


CLR 


LEN 


PFC 


STO 





Reentrant command processing routines: 
BJB IEX IUA IAF PUR 



BJS INJ 
EJB IPF 
IDT IPL 



PBS PFF RDY 
PSS PFM 
DAF PFP 
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PCS - Process queue entries 
PPU - Process PP requests 
RPC - Refill pot chains 

- Build job queue entry for scheduling a job 

- Set up for scheduling SORT job 

- Call 1TA to adjust field length 

- Process time - delay queue 

- Process WCMQ; reenter the following: 



SCH 
SOR 
SPR 
TDQ 
TSR 



DCR 


ITA 


MJE 


SRE 


HNG 


ITO 


MTO 


SSO 


ICH 


JOB 


REC 




INP 


LIN 


SEN 





General subroutines including: 



ABT' 
BRQ 
CCM 
CFL 
CJT 
CLE 
COI 
COP 



CPF GPL MQE SFL 

DAP GQE MVA SLF 

DMP GRT 06S SRC 

DPT GTA PCB SRR 

ENP GZP RPL SSP 

GEM ISH RPT TPF 

GFN LTT SAF UPF 

GFS MDA SCT UQS 



IAFEX2 - TERMINATION OVERLAY 

TAFEX2 oerfoms exit processing for the time-sharing subsystem. 

t s loaold wh^neve? an abnormal condition is detected or when 
the operator types 1.ST0P to drop the subsystem. 

When an abnorma I condition is ^^^^^1^^^^ 
the abort subroutine (ABT) is execuxea. 



IAFEX ABNORMAL - xxx 



where xxx is 



the name of the subroutine calling ABT. 



After issuing this message, if sense switch 3 is on, the ABORT 

is used to abort the control point. Routine 1AJ senses the 




i nf o rma t ion.) 



60454300 A 



37-41 



IAFEX4 - IAF/NAM INTERFACE 



The IAFEX4 overlay to IAFEX provides the interface between the 
Network Access Method (NAM) protocols and message formats and the 
internal characteristics of IAF. Figure 37-12 depicts the 



general organization of the IAFEX4 overlay; f igure 37-1 3 > shows 
the organization of the entire field length. The following 
paragraphs describe the internal design of the interface and 
relationship to the time-sharing executive and NAM. 



i ts 



The basic purpose of IAFEX4 is to send and receive data from 
terminals which are connected through NAM to IAF. In order to 
accomplish this for IAF, IAFEX4 provides thecontrol and 
connection management for all connected terminals, 
provided are as follows. 



The features 



Receives, interprets, and sends supervisory messages 

Transforms outgoing data from internal forms to the 
appropriate network format 



• Transforms incoming data from 
f o rmat 



network format to internal 



• Manages data traffic to optimize interactive performance. 

A component of NAM called the Application Interface Program (AIP) 
resides in the field length of IAFEX (refer to figure 37-13) and 
provides the data interchange between NAM and IAFEX. The 
details of the AIP are not described here; the reader should 
refer to the NAM Reference Manual for the background information 
required to fully understand the details and requirements of the 
network i nt erf ace. 

The functions of IAFEX4 are described in relation to the terminal 
functions available to the user rather than the internal 
organization of IAFEX4. This approach should provide a logical 
organization within which to describe the operation of the 



netwo 
desc r 



k i nt erf ace ove rlay . 
bed . 



The following functions are 



Connection establishment (login) 

Command line entry 

Source I i ne ent ry 

Input to a running program 

Output processing 

Session termination 
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interface control words 

interface statistics 

message headers and fixed messages 



I AF /network interface control 



terminal manager 



supervisory message processor 



upline data manager 



network interface control subroutines 



general subroutines 



data translation subroutines 



common decks and code conversion tables 



interface buffers 



application interface program (AlP) 



Figure 37-12. IAFEX4 
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RA 



RA+TXORG 



pointers and short queues 



queue pointers, statistics, and internal messages 



IAFEX1 
time-sharing executive 



IAFEX4 

• terminal conversion control 

• terminal message control 

• NAM interface (AIP) 



• terminal tables 

• queues 

• pots 



Figure 37-13. IAFEX Control Point 
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CONNECTION ESTABLISHMENT 




to it to process the message. 

;::i!i: 1 .;-j:» b i:;:;\:;i^.';. , ;i;; , ;: 1 ;.. , .".:"«. . -•••'- 

of the supervisory message. 



COMMAND LINE ENTRY 

„„.„ networ. -Hv-V- ..In .ont r,l «..■> detect s s% <- -*-_ 
from a t.r-in.l, th. re.d data ■«•« bep from the me ssage 

the message. ROM e»tratt the " nn « reUted t0 a terminal table 

3n t VaUd The e conn e ec?ion u e r ( «n> tno the terminal table entry 
entry. Th'jnM °n Assuming that the terminal is in a normal 
ratranrnoTesrrce limitations are currently e.ceeded, RDM 
calls PIN to process the input data. 
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PIN determines the correct internal format for this data and 
calls one of the translation routines to convert the received 
data from NAM to IAF format and character set. PIN calls the 
end-of-line processor CEIL), which in this case calls ECL to 
enter the command line to the executive. Pot pointers in VDPT 
are cleared and ERQ is called to enter a CLI request in the 
driver circular stack. This request causes the executive to 
accept and process the command line. Control now returns to ROM 
which indicates that this network input data has been accepted. 
RDM then returns to main control (NDR) which directs the next 
ope rat ion . 



SOURCE LINE ENTRY 

A source line is data received in text mode or 
which begins with a digit. Input which is sour 
on the primary file and this requires slightly 
processing than command line data in the networ 

All processing for data of this type is the sam 
line entry discussed above up to the point wher 
of input line) is called. EIL detects that the 
and calls ESL to enter the source line. Since 
buffered prior to writing it to the primary f i I 
actually release the input data unless it excee 
Assuming that such a condition exists, ESL call 
RIN driver stack request, resets the input init 
returns control to RDM which completes processi 
way as for command line entry. 



a I i ne of data 

ce is to be placed 

different 

k i nterf ace . 

e as for command 
e EIL (process end 

input is source 
source data is 
e, ESL does not 
ds one pot . 
s ERQ to make an 
i ated bit, and 
ng in the same 



INPUT TO A RUNNING PROGRAM 

This is handled in the network interface in the same way as 

command line entry. The read-data bit in terminal table word 

VDCT forces this to occur and the command line processor in the 
executive directs the data to the program requesting it. 



OUTPUT PROCESSING 

Processing of output to terminals in the network interface 
begins when main control CNDR) calls the terminal manager (MGR). 
The terminal manager, after performing a number of tests 
necessary for timely processing of supervisory messages and 
internal functions, calls PQO to process queued output. 

In the simple case where no special control bytes need be 
processed and there is output indicated in VDCT or VSTT, PQO 
formats the network message header and calls SPC to 'send the pot 
chain containing the message to NAM. 

SPC checks the size of the output because the exact method of 
sending data to NAM depends on whether the data is in a 
contiguous block or fragmented in a number of linked pots. 
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techniques . ) 



SPC 

r 

P 

next te rmi na I . 



returns to PQO 



in order to enter a job restart (RES) 



PC now returns to r«u in u,u«. ^ I uest has been issued, 
equest through ERQ. Af te r the res a rt requ ssing of the 
QO returns to the manager (MGR) whin conxru 




network activity continues. 



SESSION TERMINATION 

A session can be terminated in one of the following manners. 

• User logoff command 

• Logoff control byte in the output 

• Unexpected line failure 

• Network immediate shutdown 

,„. ,„.„ .....nd .. -...«.< " <;• " , ". , r«««: , ;n""'"'' 

HUP clears the pot pointer in VSTT and exits 
the network connection. 

» . ■ ^ii„rp or a similar condition which causes the connection 
A line failure or a S ^ 1L ^ detected by CON as a connection 

V th , the cdl7zl" CON ex ?. to CNB which calls CUT to clean up 
broken <CON/CB>. CO e t an Rup request t0 the 

the connection. Su ° rouI n "^ art - ons necessary to place the user 
executive which per °"-s the a etion. ecessary P ^ ^ 
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The logoff caused by a logoff control byte is detected in PQO 
which calls LOF to enter an executive COF request. When the COF 
request is processed by the executive, it returns control to the 
network interface just as for the logoff command case above. 



1TA IAFEX AUXILIARY ROUTINE 

Routine 1TA processes functions for IAFEX which require PP 
action. The functions allowed are listed in table 3.7-5. 



TABLE 37-5. PROCESS FUNCTIONS 



lOverlay I Function I Routine I 

| Name I Code 1 Name I Description 


j 3TA | 1 | TFL [Adjust IAFEX field length I 
| 3tb I 2 I RTJ IReturn terminal job I 
J 3jc | 3 I CRF ICreate rollout file I 
| 3 T0 J 4 | TLP ITerminal logout processor I 
i 3TE j 5 | DAM |Display accounting message I 
| 3 TF | 6 I TRP ITerminal recovery processor I 
i 3tg | 7 I IRL jincrement resource limit I 
|37H | 10 | RFP |Recovery file processor I 
| 3ji | 11 | SJS |Sort and job scheduler I 
| 3tj | 12 I GST JGather statistics I 
| 3 T K | 13 j CUS |Clear up SALVARE file I 



IAFEX calls 1TA in one of two ways 



GROUP REQUEST 



A group of requests are stored in pots. The input register format 
is as f o I lows . 



59 


47 


41 


35 


29 


23 


1 







1TA 


cp 





return 


pot 


IR + O 


IR + 1 


IR+2 


IR+3 


IR+4 



return 

cp 
pot 



Upper 24 bits of the word specified are set 
to zero upon completion of all requests. 
Control point number 
Pot containing the list of requests 
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The requests are o 



ne word each with the following format 



59 



unused 



35 23 

fc 



tn 



11 



org 







f c 
tn 
arg 



Function code 

Terminal number 

Pot pointer or request type 



The list of requests is terminated with a zero word. 



SINGLE REQUEST 



A single request is denoted by setting bit 35 in the input 
register which is formatted as follows. 



59 



47 41 35 



23 



11 



1TA 



cp 



IR+O 



IR + 1 



4000B+fc 



IR+2 



tn 



' IR + 3 



arg 



IR+4 



J 



cp 
f c 
tn 
arg 



Control point number 

Function code 

Termi nal number 

Pot pointer or parameter (depending on 

function) 



Routine 1TA uses severa 
These bits are: 



Bit 



4 
10 
1 1 



I bits in VROT of the terminal table 



Desc r i pt i on 



Completion status bit TACCV 

Set to indicate recall function by IAFEX 
Purge ro I lout FNT ' s 
Error return 



Figure 37-14 is the flowchart of the initialization, execution, 
and termination of the control loop for 1TA. 



60454300 A 



37-49 



1TA initialization 
INI 




set completion 

address 
(IR+2,3) ITAE 



store pot 

pointer 

(IR+4) ITAA 



SPA 



get pot 
address 



store pot 

address in 

ITAB 





/int\ 



clear single 
request flag 
bit 35 of I R 



set ITAX to 

drop PP after 

completing request 




error exit 

(erxj 



set error and 
completion bit 
in VROT for 
this terminal 




Figure 37-14. 1TA Control Loop 
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get next request (1TA) 

( ITAX \ 
I ITA1 J 



increment to 

next request 

in pot 



process function request 




set return 

address word 

complete 



drop PPU 






set error exit 
ERX+1 HAD 



store processor 
address and 
name ITAD 




set terminal 
table address 



VFNT-FN 
VFST-FS 
VROT-CN 



I 



process 

function 

LJM (ITAD) 



Figure 37-14. 1TA Control Loop (Continued) 
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set no output flag 
in rollout file 
FST (CN+4) 



write primary 

file FST in 

VFST 



write rollout 
file FST in VROT 




no 



assign output 

function VASO 

to IAFEX 



I 



FTN 



call ?P 
monitor TSEM 



i *UTAx) 



59 


47 


35 


23 


11 


2001 





last 
pot 


first 
pot 


terminal 
numbar 



Figure 37-14. 1TA Control Loop (Continued) 



60454300 A 



37-52 



!a«';:.' 1 :;.s-s,«;.:':-.st.-'!. l K"5- , l«»"- , ' ! i" :,SJ:!!1 



system sector data 

dayfile buffer pointers 

INPUT file FNT/FST 

assigned equipment 

terminal table entry 



system 
sector 



control point area 



dayfile buffer 



FNT/FST entries 



terminal output 



job field length 



Figure 37-15. Time-Sharing Job Rollout File 
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1T0 - TERMINAL INPUT/OUTPUT ROUTINE 




for the first device available. 



Routine 1T0 is also called by 1R0 to handle the J2"* b " f j! r ° f 
data on a rollout file. This data is passed to 1T0 in a PP 
buffer. Routine 1T0 dumps the PP buffer into pots and makes a 
VASO request to IAFEX for that terminal. 

The input register format when 1T0 is called by 1R0 as follows. 



59 



IR 



1TO 




cp 
tn 



IAFEX control point number 
Terminal number 



The input register when called by IAFEX is as follows 



IR 



59 




41 


35 




23 


17 





1TO 


cp 


PP 





return 



cp 

PP 

retu rn 

The request 
format. 



IAFEX control point 

POT pointer to first POT of requests 

Location of completion status word 



in POTs are 



one word entries with the following 
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35 32 26 23 




re 



eq 
track 



x 

fp 
tn 



Request code 

Correction dump 

1 Output data 
Equipment number 

First track of file if re = U, 

current track i f re = 1 1Q) 

Number of words in Last pot 

w is meaningful when re = 

Number of pots to dump; re = u 

First pot of source or output 

Terminal number 



As a group of requests is eo.pl.t.d the ^^v. .ntrl.^.r. 
ZXl d J. y rllirrZlUl aV^ n Vi?ten b ac, in the sa.e pot 
from which they came. 

The flowcharts of HO (figure 37-16) shows that it is broken 
down logicaly into the following sections. 

• Preset or initialization 

• Main loop (get next request) 

. ICH subroutines (correction handler if re = 0) 



PR 

da 



subroutines to process ° u '*P ut . J* n rC 
ta flow is disk to pots to terminal) 



= 1 (that is 
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1T0 Initialization - PRS 




set terminal 

number (IR+4) 

TN PRCB+4 



STA 



set terminal 
table address 



Read 

VFST-FS 
VROT-CN 
VSTT — CM 





read one pot 

of requests 

into EBUF 




sort requests into 

groups based on 

equipment number 




Figure 37-16. 1T0 I/O Routine 
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Figure 37-16. 1T0 I/O Routine (Continued) 
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FHD 



CUA 



select entry 
to process 




Figure 37-16. 1T0 I/O Routine (Continued) 
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STA 



set terminal 
table address 



/ ( 



1 



ODP 



( output data 
\ processing 




write 
pot 
back 





set 
completion 
for 
IAFEX/TELEX 




FTN 



drop PP 



Figure 37-16. 1TO I/O Routine (Continued) 
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Figure 37-16. 1T0 I/O Routine (Continued) 
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igure 37-16. 1T0 I/O Routine (Continued) 



Fig 
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ADDITIONAL CONSIDERATIONS 

The NETWORK or SIMFILE file specifies the numberof network 



terminals IAFEX will initialize its tables 



to ho Id. 



The $LDC issued by IAFEX 
response to terminal user typing 
BASIC subsystem. 



is a compiler call statement issued 
RUN or some similar call in 



i n 
the 



to 



SALVARE - IAFEX RECOVERY FILE 

The SALVARE file is a fast attach pe ^^^^{^^'^covery 18 ? 
during an initial deadstart or recovered during a ^°^y 
deadsLrt. The size of the file is dete .fined by ISF and its 

length is not altered by IAFE) ^: c J S ^-^ t re ence devi ce 
length does not exceed one logical tracK on xne 

During initialization, IAFEX reads the s ALVAR \^ e .^ done 
subroutine URT to update the recovery tn.es. This is done 
assure that a user has VNTO minutes to recover, no matter 
how long a system recovery has taken. 

During operation in IAFEX1, the main loop calls CSF. ?SF Issues 
a 1TA queue call to check the SALVARE file in 1TA routine CUS 

unlJionTo. CUS clears all entries in the SALVARE file and 
logs off users over VNTO minutes old. This call is made about 
e vey 3 mi nut es . 

Routine 1TA is a combination of funct ions to per form fo r IA FEX . 
The important functions associated with the SALVARE are as 
follows. 



Funct i on 

CUS 
TLP 
TRP 



RFP 

Since the SALVARE 
ent r i es more than 



f i le 
VNTO 



Pes c ri pt i on 

Clean up f i le 

Terminal log out processor 

Terminal recovery processor; this 

overlay contains the SALVARE format 

document at ion 

Recovery file processor 

is checked about every 3 minutes and 
minutes old are eliminated, then: 



• A user that wishes to be recovered after losing contact 
must attempt recovery within VNTO minutes. 

• Entries in the SALVARE file are updated upon system 
recovery so that a user is assured of the full time-out 
period after system recovery. 
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,. haH in the recovery file processor routine, 
Recovery is accomplished i the re y 
RFP, The call to overlay RFP is as toitows. 




Upon entry, IR + 4 contains the parameter pel ^^J^ ' 
contains the terminal table, IR+4 i s set \° » t 

terminal number, .which is recovered from parameter po 



59 



IR 



1TA 



41 







35 



23 



I5B 



tnn 



11 



tnb 







tnn 
tnb 

To recover a user, 
the information is 

t 



Terminal number now 
Terminal number before 

the entry on the SALVARE file is founc i and 

returned to the terminal table,^ ™ e u entry 



i n 



HI U s Uared and the current rollout fil 

released A dayfile message is issued indicate the u 



1 s 
ser 



recovered . 



there 




returned as 0003. 



If 1TA finds the 
it 



The SALVARE file is always at FNT ordinal 1. +. ma ^ 

file active or destroyed (unrecognizable at recovery time) .- 
hangs wiih the MXFN monitor function. The format for the file 
as f ol lows . 



i s 



37-63 



60454300 A 



59 



fo 



53 



47 



eq 



ft 



35 29 23 17 11 



hrs 



mm 



sec 



reserved for CDC 



user index 



to 



fo 

eq 

ft 

hrs 

i a 

to 



mi n. sec 



Family equipment ordinal 

EST ordinal of rollout file 

First track of rollout file 

Last entry time in compressed format 

Installation reserved area 

Terminal table ordinal 
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